@i-novus/n2o-components
v7.29.20
Published
UI components for N2O framework
Readme
@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 — тесты.
