Распространение

Артефакты сборки

Скрипты сборки

Исходный код

bun scripts/cva-extractor.ts

генерирует

выдает

выдает

bunx buildy-ui scan

сканирует

сканирует

генерирует

публикует

safelist для
очистки Tailwind

src/core/ui/
Примитивы: Block, Box, Grid и т.д.

src/core/variants/
Определения вариантов CVA

src/components/ui/
Составные компоненты

src/layouts/
Шаблоны макетов

src/index.ts
Главная точка входа

scripts/cva-extractor.ts
Извлекает 618 CSS-классов

tsc -p tsconfig.json
Компилятор TypeScript

eslint src --ext .ts,.tsx
Проверка качества кода

buildy-ui scan
Генерация реестра

src/lib/core-classes.json
Белый список из 618 классов

dist/index.js
Вывод модуля ES2022

dist/index.d.ts
Объявления TypeScript

src/registry.json
Метаданные компонентов

Пакет NPM
@ui8kit/Unsupported markdown: link

Файлы пакета:
dist/**, README.md, LICENSE

Приложения
потребителей

Выходные данные

Процесс компиляции

Настройки компилятора

Входные данные компиляции

tsconfig.json
Конфигурация компилятора

src//*.ts
src//*.tsx
Исходный код TypeScript

target: ES2022
Современные возможности JavaScript

module: ES2022
moduleResolution: Bundler

jsx: react-jsx
Преобразование JSX React 18+

Псевдонимы путей:
@/* → ./src/*

Проверка типов
strict: true

Преобразование JSX
react-jsx runtime

Генерация объявлений
declaration: true

Генерация файлов
outDir: ./dist

dist/index.js
Модули ES2022

dist/index.d.ts
Объявления типов

dist//*.js
dist//*.d.ts
Скомпилированные подмодули

// Конфигурация псевдонимов путей
{
  "@/*": ["./src/*"],              // Сопоставляет @/ с src/
  "@ui8kit/core": ["./src/index"]  // Сопоставляет импорт пакета с src/index
}

Каталог вывода dist/

Поддерживающие модули

Модули макетов

Модули компонентов

Основные модули

импортирует

импортирует

импортирует

импортирует

импортирует

импортирует

dist/themes/
Система тем

dist/index.js
Главный модуль точки входа

dist/core/ui/
Скомпилированные примитивные компоненты

dist/core/variants/
Определения вариантов CVA

dist/components/ui/
Составные компоненты

dist/layouts/
Шаблоны макетов

dist/hooks/
React-хуки

dist/ui/
Экспорты UI-компонентов

dist/core/utils/
Утилитарные функции

dist/index.d.ts
Главные объявления типов

// Структура экспорта из src/index.ts
export * from './core/variants';      // Определения вариантов
export * from './core/utils';         // Утилитарные функции

// Базовые примитивы с префиксом Base
export {
  Block as BaseBlock,
  Box as BaseBox,
  // ... и т.д.
} from './core/ui';

// Составные компоненты (основные экспорты)
export * from './ui';                 // Button, Card и т.д.

// Компоненты макетов
export * from './layouts';            // DashLayout, LayoutBlock и т.д.

// Система тем
export * from './themes';             // ThemeProvider, useTheme

// React-хуки
export * from './hooks';

{
  "main": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  }
}

{
  "files": [
    "dist/**/*",      // Весь скомпилированный вывод
    "README.md",      // Документация
    "LICENSE"         // Файл лицензии
  ]
}

Процесс экстрактора CVA

Извлечение классов

Базовые классы
Строки первого аргумента

Вход:
src/core/variants/**/*.ts
Все файлы определений вариантов

Babel Parser
Парсинг AST TypeScript

Обход AST
Поиск вызовов cva()

Классы вариантов
Свойства объектов

Составные варианты
Вложенные объекты

Дедупликация
Уникальность на основе Set

Выход:
src/lib/core-classes.json
618 уникальных классов

{
  "classes": [
    "absolute",
    "accent-auto",
    // ... еще 616 классов
    "z-auto"
  ],
  "count": 618,
  "timestamp": "2025-10-29T12:17:54.882Z"
}

Использование во время выполнения

Зафиксированные артефакты

Генерация во время сборки

создает

создает

создает

npm run build

bun scripts/cva-extractor.ts

npm run scan

dist/
Скомпилированный JS + типы
Генерируется tsc

src/lib/core-classes.json
618 CSS-классов
Генерируется экстрактором CVA

src/registry.json
Метаданные компонентов
Генерируется buildy-ui

npm install @ui8kit/core
Устанавливает вывод dist/

Consumer tailwind.config.js
Использует core-classes.json

npx buildy-ui add button
Использует registry.json

# 1. Извлечение классов CVA (обновляет src/lib/core-classes.json)
bun scripts/cva-extractor.ts

# 2. Проверка типов исходного кода
npm run type-check

# 3. Линтинг исходного кода
npm run lint

# 4. Компиляция TypeScript (генерирует dist/)
npm run build

# 5. Генерация реестра компонентов
npm run scan

# 6. Публикация в NPM (из packages/registry/)
npm run publish

# Быстрая сборка для тестирования
npm run build

# Или просто проверка типов без генерации
npm run type-check

npm run lint          # Качество кода
npm run type-check    # Безопасность типов
npm run build         # Компиляция

# 1. Проверьте существование dist/ и наличие файлов
ls -la dist/

# 2. Убедитесь, что главные точки входа существуют
ls -la dist/index.js dist/index.d.ts

# 3. Проверьте, что белый список CVA актуален
cat src/lib/core-classes.json | grep count

# 4. Убедитесь, что реестр текущий
cat src/registry.json | grep version