Establish NODE.DC design system baseline

2026-07-10 02:34:36 +03:00
commit 73629d68c3
63 changed files with 6701 additions and 0 deletions
@@ -0,0 +1,61 @@
+# NODE.DC Design Guideline
+
+Единый источник компонентов и правил интерфейса NODE.DC.
+
+Это не архив скриншотов и не описание того, как разные приложения когда-то стилизовали одинаковый контрол. Репозиторий содержит реальные переиспользуемые пакеты, машинный реестр и живой каталог. Новые приложения должны подключать эти пакеты, выбирать тему/акцент и собирать предметный интерфейс из готовых элементов.
+
+## Что здесь является каноном
+
+- общая геометрия приложения и верхней панели;
+- glass-материал, поверхности и слои;
+- кнопки, поля, чекеры, range, select и dropdown;
+- модальные окна, подтверждения и боковые окна;
+- segmented navigation и статусы;
+- инспектор/панель настроек нового поколения;
+- поведение 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.1.x` — зафиксированный baseline. Исходные приложения на первом этапе не изменяются. Компоненты здесь построены по подтверждённым реализациям Launcher/Hub, CMS/SEO и двум новым участкам Engine: настройкам окружения и инспектору агентной ноды.
+
+Подробности:
+
+- [Архитектура](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)
+