# NODE.DC Design Guideline

Единый источник компонентов и правил интерфейса NODE.DC.

Это не архив скриншотов и не описание того, как разные приложения когда-то стилизовали одинаковый контрол. Репозиторий содержит реальные переиспользуемые пакеты, машинный реестр и живой каталог. Новые приложения должны подключать эти пакеты, выбирать тему/акцент и собирать предметный интерфейс из готовых элементов.

## Что здесь является каноном

- общая геометрия приложения и верхней панели;
- glass-материал, поверхности и слои;
- кнопки, поля, чекеры, range, select и dropdown;
- модальные окна, подтверждения и боковые окна;
- segmented navigation и статусы;
- Hub header и левая admin navigation panel;
- инспектор/панель настроек нового поколения;
- поведение portal-слоёв, Escape, outside click и фокуса;
- контракт темы: приложения меняют цветовую схему, а не геометрию компонентов.

## Что не является каноном

- старые инспекторы и старые плашки Engine;
- legacy dropdown/menu реализации Task Manager;
- доменная логика нод, BIM-моделей, SEO pipeline или задач;
- локальные копии компонентов внутри приложений.

## Пакеты

- `@nodedc/tokens` — JSON и CSS custom properties.
- `@nodedc/ui-core` — общие стили, тема, контраст и расчёт floating-layer.
- `@nodedc/ui-react` — React-компоненты.
- `@nodedc/ui-dom` — JS/DOM-контроллеры для BIM Viewer, CMS и других приложений без React.
- `@nodedc/ui-catalog` — живой стенд всех канонических компонентов.

## Быстрый запуск каталога

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

Полная проверка:

```bash
npm run check
npm run build
```

## Статус

Версия `0.2.x` — уточнённый baseline с точной геометрией Hub header/admin panel и новых Engine settings/agent inspector. Исходные приложения на первом этапе не изменяются.

Подробности:

- [Архитектура](docs/ARCHITECTURE.md)
- [Компоненты](docs/COMPONENTS.md)
- [Темы](docs/THEMING.md)
- [Окна и слои](docs/WINDOWS_AND_LAYERS.md)
- [Границы исходного аудита](docs/SOURCE_BASELINE.md)
- [Правила развития](docs/GOVERNANCE.md)
- [План подключения приложений](docs/ADOPTION.md)
- [Инвентарь следующих компонентов](docs/CANDIDATES.md)