# GNexus UI Kit Docs

GNexus UI Kit - набор HTML/CSS/JS компонентов для внутренних интерфейсов GNexus.
Документация в этой директории описывает, как подключать kit и как собирать из него реальные экраны.

## С чего начать

- [Getting Started](getting-started.md) - подключение CSS, иконок и JS bundle.
- [Style Guide](style-guide.md) - визуальные правила, токены, spacing и типографика.
- [JavaScript API](javascript.md) - глобальный namespace и автоинициализация.
- [Vue Adapter](vue.md) - официальный Vue слой поверх CSS/JS контракта kit.
- [Vue Component API](vue/component-api.md) - props, emits, slots и короткие примеры.
- [Vue Cookbook](vue/cookbook.md) - практичные сценарии экранов.
- [Vue Migration Policy](vue/migration-policy.md) - правила совместимости Vue adapter.
- [Release Flow](release.md) - проверки, pack validation и публикация пакета.

## Компоненты

- [Foundations](components/foundations.md) - typography, palette, buttons, utilities.
- [Navigation](components/navigation.md) - Navigation Shell, tabs, dropdown, tooltip, popover, drawer.
- [Forms](components/forms.md) - input, select, date/time, file upload, checkbox/radio, advanced select.
- [Data Display](components/data-display.md) - tables, lists, cards, description list, timeline, avatar, badges, chips.
- [Feedback](components/feedback.md) - alerts, toasts, modals, confirm dialog, progress, skeleton.
- [Layout Patterns](components/layout-patterns.md) - page header, toolbar, pagination, empty state, steps, accordion.
- [Component Coverage](component-coverage.md) - соответствие demo-секций страницам документации.

## Где смотреть живые примеры

Локальная demo/docs страница собирается из `demo/index.html` и `demo/partials/*.html`.

```bash
npm install
npm run dev
```

После запуска:

```text
http://localhost:3000
```

## Что считать источником правды

- Для поведения компонентов: `src/js/components/`.
- Для CSS API: `src/scss/components/`.
- Для копируемой разметки: `demo/partials/`.
- Для человеческих правил использования: `docs/`.
