# @i-novus/n2o-components

UI‑библиотека React-компонентов для **N2O framework**.

- Пакет: `@i-novus/n2o-components`
- Назначение: базовые UI-компоненты (inputs, кнопки, лэйауты, навигация, типографика, display-компоненты), стили и утилиты, используемые в экосистеме N2O.
- Стек: **React + TypeScript**, стили на **SCSS** (внутри пакета есть `src/styles`).

---
### Notes
- **lib** — собранный артефакт (build result; сюда попадает JS/d.ts/scss styles).
- **Исходники** находятся в `src/`. Новые компоненты рекомендуется добавлять в соответствующие папки (`inputs/`, `navigation/`, …).
- **Стили** хранятся в `src/styles`. Компонентные стили/миксины/переменные должны переиспользоваться оттуда.
- **globalExtensions** необходимо импортировать вручную `import '@i-novus/n2o-components/lib/globalExtensions/globalExtensions'`.

---
## Основная структура src

#### Компоненты
- inputs — инпуты и контролы ввода: поля, селекты, чекбоксы, маски, редакторы и т.п.
  Обычно здесь же находятся адаптеры/обёртки над сторонними input-библиотеками и общие для inputs интерфейсы.
- button — кнопки и близкие сущности (варианты кнопок, группы, иконки/лоадеры на кнопках и т.д.).
- display — компоненты отображения данных (не ввод): бейджи, теги, статусы, лейблы, превью/значения, различные “view”-компоненты.
- layouts — компоненты размептки: контейнеры, панели, сетки/колонки, обёртки для выравнивания, «каркасы» для страниц/виджетов.
- navigation — навигация: меню, хлебные крошки, вкладки, сайдбар/хедер-навигация и т.п.
- Typography — типографика: заголовки, текстовые стили, компоненты для единообразного вывода текста.

#### Стили
- styles — SCSS-стили: базовые переменные/миксины, темы, общие стили компонентов.

#### Вспомогательные ресурсы
- globalExtensions - глобально подключенные плагины.
- helpers — вспомогательные функции/обёртки “прикладного” уровня: форматирование, маппинги, небольшие хелперы для компонентов.
- utils — более “низкоуровневые” утилиты общего назначения (работа с типами, объектами, датами, проверками и т.п.), не привязанные к конкретным компонентам.
- types.ts — общие TypeScript-типы/интерфейсы, которые переиспользуются по всему пакету.
- tests — тесты.