69 lines
3.7 KiB
Markdown
69 lines
3.7 KiB
Markdown
# NODE.DC Design Guideline
|
||
|
||
Единый источник компонентов и правил интерфейса NODE.DC.
|
||
|
||
Это не архив скриншотов и не описание того, как разные приложения когда-то стилизовали одинаковый контрол. Репозиторий содержит реальные переиспользуемые пакеты, машинный реестр и живой каталог. Новые приложения должны подключать эти пакеты, выбирать тему/акцент и собирать предметный интерфейс из готовых элементов.
|
||
|
||
## Что здесь является каноном
|
||
|
||
- общая геометрия приложения и верхней панели;
|
||
- glass-материал, поверхности и слои;
|
||
- кнопки, поля, чекеры, range, select и dropdown;
|
||
- модальные окна, подтверждения и боковые окна;
|
||
- segmented navigation и статусы;
|
||
- Hub header и левая admin navigation panel;
|
||
- launcher-style ApplicationShell без обязательной нижней витрины;
|
||
- единый state-controller открытия navigation/content окон;
|
||
- CMS/Launcher media field: файл, URL, превью и storage-adapter;
|
||
- аудированный общий набор иконок;
|
||
- инспектор/панель настроек нового поколения;
|
||
- поведение 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.4.x` — пакетный Launcher-пресет шапки и оконного workspace, media/settings patterns, точная геометрия Hub/Engine и центральный каталог иконок. Исходные приложения на первом этапе не изменяются.
|
||
|
||
Подробности:
|
||
|
||
- [Архитектура](docs/ARCHITECTURE.md)
|
||
- [Компоненты](docs/COMPONENTS.md)
|
||
- [Шаблон приложения](docs/APPLICATION_TEMPLATE.md)
|
||
- [Иконки](docs/ICONS.md)
|
||
- [Темы](docs/THEMING.md)
|
||
- [Окна и слои](docs/WINDOWS_AND_LAYERS.md)
|
||
- [Границы исходного аудита](docs/SOURCE_BASELINE.md)
|
||
- [Правила развития](docs/GOVERNANCE.md)
|
||
- [План подключения приложений](docs/ADOPTION.md)
|
||
- [Как подключать пакеты в новый проект](docs/CONSUMPTION.md)
|
||
- [Инвентарь следующих компонентов](docs/CANDIDATES.md)
|