Этап 0 · Фундамент
готово- Nuxt-модуль — регистрация компонентов, префикс, автоимпорт
- Тема на CSS-переменных — токены, TW3 + TW4, 3 уровня темы
- Манифест — vue-component-meta → JSON: дока для сайта и MCP
Сборка 0.1.0-alpha · в разработке
Личный UI-бандл вместо тяжёлых библиотек: обычные утилитарные классы, тема на CSS-переменных в три уровня, одна runtime-зависимость. Работает в Tailwind 3 и Tailwind 4 из одного пака.
Возможности
Три кита: тема трёх уровней, поддержка двух мажоров Tailwind из одного пака и дока, которая собирается из кода компонентов.
Тема
Словари внутри компонентов → глобальный файл темы потребителя → :ui-проп при вызове. tailwind-merge решает конфликты утилит, обычный class работает как обычно.
Уровень 1 · словари в компоненте
Уровень 2 · файл темы потребителя
skobUi: { theme: { skButton: { slots: { root: 'rounded-full' } } } }Уровень 3 · :ui-проп при вызове
<SkButton :ui="{ root: 'w-full' }">Ок</SkButton>Совместимость
У проектов владельца есть и TW3, и TW4 — пак обязан работать в обоих. Значения токенов живут в CSS-переменных, смена скина — без пересборки.
Один и тот же клас-набор в TW3 (theme.extend) и TW4 (@theme): значения живут в CSS-переменных --sk-*.
Документация
JSDoc в коде компонента — обязательная дока. Скрипт собирает манифест, из него кормятся сайт, MCP-сервер и README-таблицы. Дока не может разойтись с кодом.
Один источник правды: vue-component-meta вытаскивает пропсы/события/слоты и JSDoc-текст, манифест кормит сайт, MCP и README.
Состав
Компоненты принимаются в сборку по одному: сначала витрина на этом сайте, потом твоя правка — и только потом npm-релиз.
Этап 0 · Фундамент
готовоЭтап 1 · Ядро форм
в работеЭтап 2 · Оверлеи
в планеЭтап 3 · Данные и навигация
в планеЭтап 4 · Расширенные формы
в планеЭтап 5 · Пикеры
в плане · обязательный этапБыстрый старт
Пак подключается как Nuxt-модуль: тема, токены и source-пути он добавляет сам.
pnpm add skob-ui
# или: npm i skob-ui// nuxt.config.ts
export default defineNuxtConfig({
modules: ['skob-ui']
})Принципы
skob-ui пишется как для публичной библиотеки, хотя живёт в личных проектах.
Одна runtime-зависимость — tailwind-merge. Исходники .vue в дистрибутиве, компилирует Tailwind потребителя. Никаких прекомпилов и тяжёлых бандлов.
Обычные утилитарные классы из дизайн-токенов, никаких arbitrary-значений. Один радиус, одна шкала текста, единые состояния — компоненты выглядят семьёй.
Тема настраивается владельцем: токены → файл темы → :ui-проп. Никаких «пресетов из коробки» — только то, что ты сам решил.
FAQ
Три уровня: дефолтные словари внутри компонентов; глобальный файл темы у потребителя (токены + словари по слотам); :ui-проп при вызове. Смена скина — правка CSS-переменных без пересборки. Попробуй переключателем в шапке.
<SkButton :ui="{ root: 'w-full rounded-none' }">
Точечная правка слота
</SkButton>