@true-engineering/true-react-common-ui-kit 3.55.0 → 3.56.1

package/README.md

@@ -2,740 +2,24 @@
 
 Модульный UI Kit на React с поддержкой темизации.
 
-# Публикация
-
-Слить Pull Request с увеличением версии пакета в файле `package.json` в ветке `master`.
-Не забыть добавить описание изменений в этот файл.
-
-Публикация в npm и добавление тега на коммит c версией пакета происходит автоматически в пайплайне.
-Так же автоматически будет создан коммит в репозиторий TE_TrueReactPlatform_Moduled и обновится наш сторибук
-
 # Release Notes
 
-## 3.55.0
-
-### Changes
-
-- **Select**: Добавлен экспорт компонента `SelectList`
-- **List**: Для `ListItem` добавлена опция `isHidden`
-
-## 3.54.0
-
-### Changes
-
-- **TweakStyles**: Теперь могут быть массивом. Адаптированы типы и хелперы
-- **createThemedStyles**: Добавлен режим `tweakStylesArch="react-jss"`, оптимизирующий работу с tweakStyles
-- **createThemedStyles**: Добавлен режим `tweakStylesArch="true-jss"` (бета)
-
-## 3.53.1
-
-### Changes
-
-- **PhoneInput**: Исправлено обрезание лейбла многоточием
-- **SearchInput**: Исправлено обрезание лейбла многоточием
-
-## 3.53.0
-
-### Changes
-
-- **FiltersPane**: Добавлен проп `shouldRenderDataId`, который добавляет атрибут `data-id` со значением из конфига.
-- **FiltersPane**: Изменена типизация дженериков, добавлены тайпгарды
-
-## 3.52.0
-
-### Changes
-
-- **DatePicker**: Теперь в качестве локали принимается так же строка "ru" | "en"
-
-## 3.51.0
-
-### Changes
-
-- **FlexibleTable**: Исправлена мемоизация строк при смещении
-
-## 3.50.1
-
-### Changes
-
-- **Select**: Исправлено обрезание лейбла многоточием
-
-## 3.50.0
-
-### Changes
-
-- **TextArea**: Добавлено обрезание лейбла многоточием.
-- **Input**: Добавлено обрезание лейбла многоточием. HTML-структура поменялась с `inputWrapper > input` на `inputWrapper > inputWithLabelWrapper > input`.
-
-  Это также повлияло на все компоненты, использующие **Input**:
-
-  - **DateInput**
-  - **NumberInput**
-  - **PhoneInput** – если вы переопределяли через твик-стайлы правило `margin-left` для класса `label`,
-    это переопределение нужно удалить, т.к. `margin-left` теперь в стандартном случае не должно быть
-  - **PhoneInputCountryList**
-  - **SearchInput** – если вы переопределяли через твик-стайлы правило `left` для класса `label`,
-    это переопределение нужно удалить, т.к. `left` теперь в стандартном случае должно быть равно `0`
-  - **Select**
-  - **SmartInput**
-
-## 3.49.0
-
-### Changes
-
-- **FiltersPane**: Добавлен `getSelectedValue` для удобного рендера значения в `custom`-фильтре с `valueViewType: 'multiple'`
-- **FiltersPane**: Добавлен экспорт `ICustomComponentProps` для `CustomComponent` в `ICustomConfigItem`
-- **FiltersPane**: Кастомный фильтр разделён на два типа `ICustomRangeConfigItem` и `ICustomMultipleConfigItem`
-
-## 3.48.0
-
-### Changes
-
-- **FlexibleTable**: Добавлен rowRef
-
-## 3.47.0
-
-### Changes
-
-- **Select**: Добавлен ref в пропсу `searchInput` Select-а
-- **Select**: Добавлен shouldFocusOnMount в пропсу `searchInput` Select-а
-
-## 3.46.0
-
-### Changes
-
-- **SearchInput**: Добавлен forwardRef
-
-## 3.45.6
-
-- **phone.ts** Изменён алгоритм определения кода страны по номеру телефона
-- **phone-info.ts** Добавлены dialCode для Южной Осетии
-- **phone-info.ts** Актуализированы dialCode для Казахстана
-
-## 3.45.5
-
-### Changes
-
-- **Tooltip**: Добавлен вариант `custom` для `view`
-
-## 3.45.4
-
-### Changes
-
-- **Select**: Убирает лишние вызовы `onBlur` при использовании Popper, если поле не открыто
-
-## 3.45.3
-
-### Changes
-
-- **Flag**: Добавлены флаги для Абхазии и Южной Осетии
-- **PhoneInput**: Добавлены PhoneInfo для Абхазии и Южной осетии.
-- **PhoneInput**: Исправлен баг с невозможностью выбора стран с одинаковыми dialCode
-
-## 3.45.2
-
-### Changes
-
-- **SearchInput**: Добавлен класс `iconClickable`
-
-## 3.45.0
-
-### Changes
-
-- **Input**: Добавлена стандартная пропса `inputMode`
-- **SearchInput**: Добавлена пропса `onSearchIconClick`
-
-## 3.44.1
-
-### Changes
-
-- **WithPopup**: Явный рендер попапа в `document.body`
-
-## 3.44.0
-
-### Changes
-
-- **WithPopup**:
-
-  1. Реализована возможность отрисовки стрелочки
-  2. Добавлены пропсы `arrow` и `arrowProps`
-  3. Добавлена пропса `isMinWidthSameAsTrigger`, которая выставляет минимальную ширину попапа равной ширине триггера
-  4. Добавлена пропса `popupData`, которая позволяет прокинуть data-атрибуты в попап
-  5. В `children` добавлена пропса `floatingContext`, возвращаемый хуком `useFloating`
-  6. Дефолтное значение пропсы `shouldStopPropagation` изменено с `true` на `eventType === 'click`
-
-- **WithTooltip**: `zIndex` тултипа как в `TextWithTooltip` (9999)
-
-## 3.43.0
-
-### Changes
-
-- **withScrollBar**: Переносит константы размеров скролла в CSS-переменные: `--webkit-scrollbar-width` и `--webkit-scrollbar-height`
-
-## 3.42.0
-
-### Changes
-
-- **FiltersPane**: Добавляет `isClearable` в `filtersConfig`
-- **FiltersPane**: Заменяет шеврон на крестик у элемента фильтра при активном `isClearable`. Нажатие на крестик производит очистку фильтра
-
-## 3.41.0
-
-### Changes
-
-- **SmartInput**: Переписан + исправлен баг с неправильной позицией каретки при повторном вводе
-- **SmartInput**: Добавлена пропса `isTransliterationEnabled`
-- **SmartInput**: У `onChange` добавлено два новых аргумента `rawValue` и `event`
-
-## 3.40.0
-
-### Changes
-
-- Добавлен компонент **WithTooltip** (`floating-ui`)
-- **TextWithTooltip** deprecated
-
-## 3.39.0
-
-### Changes
-
-- **FlexibleTableCell**: Добавляет `onCellClick` в `config`
-
-## 3.38.0
-
-### Changes
-
-- **Select**: Запрещает открывать `SelectList` при `isReadonly`
-
-## 3.37.0
-
-### Changes
-
-- **IUiKitTheme**: Удалено поле name
-
-## 3.36.0
-
-### Changes
-
-- **ListItem**: Добавляет экспорт ListItem
-
-## 3.35.0
-
-### Changes
-
-- **FlexibleTable**: новая пропса `shouldRenderHeader`
-
-## 3.34.0
-
-### Changes
-
-- **Toaster**: Пропы `title` и `text` заменёны на `ReactNode`
-- **Toaster**: Обработан случай бесконечного `timeout` (напр. Infinity)
-
-## 3.33.2
-
-### Changes
-
-- **FlexibleTableCell**: Кастомизирована проверка необходимости отрисовки
-
-## 3.33.1
-
-### Changes
-
-- **FlexibleTable**: Поведение пропсы `position` стало таким же как `isFirstColumnSticky`
-
-## 3.33.0
-
-### Changes
-
-- **WithPopup**: Пропсы триггера разделены на `referenceProps` (для тегов) и `triggerProps` (для компонентов)
-- **WithPopup**: Для `isActive` триггера добавлен класс `active`
-- **WithPopup**: Для `flip` добавлен `fallbackAxisSideDirection`
-- **ICommonProps**: Разделены на составляющие (чтоб не пикать/омитить)
-
-## 3.32.0
-
-### Changes
-
-- **Notification**: Добавлен проп `icon`
-- **Notification**: В проп `type` добавлен вариант `custom`
-
-## 3.31.0
-
-### Changes
-
-- **FlexibleTable**: Добавлен экспорт `IFlexibleTableRowConfig`
-
-## 3.30.0
-
-### Changes
-
-- **WithPopup**: Добавлен проп `shouldStopPropagation` для изменения поведения при onClick
-- **WithPopup**: Исправлено поведение всплытия при нажатии на триггер
-
-## 3.29.1
-
-### Changes
-
-- **Select**: Убирает `isActive` из `Omit`
-
-## 3.29.0
-
-### Changes
-
-- **FlexibleTableRow** Убрана зависимость от `activeRows`, добавлен проп `isActive`
-- **FlexibleTableRow** Добавлен проп `isFocusable` для контроля ререндера строки при ховере
-- **FlexibleTableCell** Добавлен проп `isActiveRow`
-- **FlexibleTable** Значения `renderMode` собраны в `TableRenders`
-- **FlexibleTable** Значения добавлен проп `isRowFocusable`
-
-## 3.28.4
-
-### Changes
-
-- **FilterWrapper**: Поправлено взаимодействие с **WithPopup**
-
-## 3.28.3
-
-### Changes
-
-- **List**: Фикс `testId` у айтемов
-- **WithPopup**: Фикс рендера пропсы `isDisabled`
-
-## 3.28.2
-
-### Changes
-
-- **List**: `shouldDrawSpacerBelow` и `shouldDrawSpacerAbove` теперь не рендерятся первыми и последними в списке
-
-## 3.28.1
-
-### Changes
-
-- **ListItem**: `onClick` стал опциональным. При отсутствии - базовый `onClick` **List** вызван не будет
-
-## 3.28.0
-
-### Changes
-
-- Поднята версия `true-react-platform-helpers` (требуется `node:20`)
-- Подняты версии `jss` и `react-jss` (можно избавляться от `resolutions`)
-- **transformToKebab** и **addDataAttributes**: помечены как `deprecated`
-- **useTweakStyles**: усилен тип ClassName
-- **FlexibleTable**: `IValueComponent` и `ITitleComponent` заменены на `IValueComponentProps` и `ITitleComponentProps`
-- **FlexibleTable**: `title` и `component` переписаны на `IRenderNode`, `titleComponent` удален
-- **FlexibleTable**: добавлена типизация для `uniqueField` и соответствующих `onRowClick` и `onRowHover`
-- **FlexibleTable**: добавлена типизация для `headerContent` и ~~`titleComponent`~~ `title`
-
-## 3.27.1
-
-### Changes
-
-- **List**: Фикс стилей отступов
-
-## 3.27.0
-
-### Changes
-
-- **List**: Добавлена поддержка вложенных пунктов меню
-- **IListItem**: Новое свойство `nestedItems` для рендера вложенных пунктов меню
-
-## 3.26.1
-
-### Changes
-
-- **Input**: Исправлен баг с позиционированием `label` при `shouldAlwaysShowPlaceholder`
-
-## 3.26.0
-
-### Changes
-
-- **WithPopup**: Компонент переписан в соответствии с документацией
-- **WithPopup**: Изменены сигнатуры `trigger` и `children`
-- **WithPopup**: Новое свойство `isTriggerWrapped` - должен ли WithPopup рендерить свой div-wrapper в качестве триггера
-- **WithPopup**: `onToggle` - добавлен event вторым параметром
-- **WithPopup**: `shouldRenderInBody` - дефолтное значение теперь `true`
-- **Button**: Добавлено наследование от `IDomInteractions` для поддержки всех событий пробрасываемых **WithPopup**
-
-## 3.25.1
-
-### Changes
-
-- **NumberInput**: Фикс бага с неправильным поведением каретки
-
-## 3.25.0
-
-### Changes
-
-- **Select**: Добавлена поддержка проп `header` и `footer`
-- **Select**: Исправлено отображение дропдауна в случае, если у поля есть `errorMessage`
-- **Select**: Добавлен `tabIndex` для списка, с целью корректной работы для [Keyboard-focusable scroll containers](https://chromestatus.com/feature/5231964663578624)
-
-### Chore
-
-- **Select**: Исправлен каст типа `Styles` на `CSSProperties`
-- **Select**: Удалён type guard для проверки `isMultiSelect`
-- **SelectList**: Исправлены проверки на `isMultiSelect`
-- **TextWithTooltip**: Исправлен каст типа `Styles` на `CSSProperties`
-
-## 3.24.1
+[Changelog для версии 3.x.x](./CHANGELOG_v3.md)
 
-### Changes
+[Changelog для версии 2.x.x](./CHANGELOG_v2.md)
 
-- Фикс бага с перерендером внутренних компонентов таблицы
+# Версионность
 
-## 3.24.0
+При выборе версии пакета придерживаемся [семантического версионирования](https://semver.org/lang/ru/).
 
-### Changes
+Основная разработка ведется в ветке – **master**
 
-- Добавлены компоненты: **FileInput**, **FileItem**
+Разработка следующей мажорной версии в ветке – **next**
 
-## v3.23.0
-
-### Changes
-
-- **DatePicker**: добавлена пропса `excludeScrollbar`
-
-## v3.22.0
-
-### Changes
-
-- **DatePicker**: добавлена пропса `fixedHeight`
-
-## v3.21.0
-
-### Changes
-
-- **DatePicker**: добавлена пропса `highlightDates`
-
-## v3.20.1
-
-### Changes
-
-- **TextArea**: убран дефолтный цвет `invalidLabel`
-
-## v3.20.0
-
-### Changes
-
-- **TextArea**: добавлена пропса `shouldAlwaysShowPlaceholder`
-
-## v3.19.0
-
-### Changes
-
-- **Select**: добавлен синхронный вызов onType при debounceTime = 0
-
-## v3.18.0
-
-### Changes
-
-- **WithPopup**: добавлены классы для анимации
-- **FilterWrapper**: анимация вынесена в темы
-
-## v3.17.0
-
-### Changes
-
-- **FlexibleTable**: добавлена пропса shouldRenderDataId для config, включающая рендер data-id={columnName} для ячеек
-
-## v3.16.0
-
-### Changes
-
-- **FiltersPane**: добавлены tweakStyles для FilterWrapper
-- **FilterWrapper + Filter**: переписан с использованием WithPopup
-- **FilterSelect**: добавлено свойство onClose
-- **WithPopup**: добавлена поддержка transition
-- **NewMoreMenu**: добавлен свойство onToggle
-
-## v3.15.4
-
-### Changes
-
-- **TextArea**: исправлен scrollPadding
-
-## v3.15.3
-
-### Changes
-
-- **TextArea**: добавлен scrollPadding
-
-## v3.15.2
-
-### Changes
-
-- **TextArea**: багфикс опечатки в имени класса
-
-## v3.15.1
-
-### Changes
-
-- **MultiSelectList**: исправлено отображение фильтра с `not found`, если есть выбранные элементы
-
-## v3.15.0
-
-### Changes
-
-- **TextArea**: рефакторинг ресайза и добавление свойства isAutoSizeable
-
-## v3.14.2
-
-### Changes
-
-- **Selector**: исправлены стили задизейбленной опции
-
-## v3.14.1
-
-### Changes
-
-- **WithPopup**: исправлен баг с невозможностью закрытия popup при нажатии на элемент
-
-## v3.14.0
-
-### Changes
-
-- **WithPopup**: добавлена пропса `canBeFlipped` для автоматического позиционирования
-- **NewMoreMenu**: добавлена пропса `canBeFlipped`
-
-## v3.13.1
-
-### Changes
-
-- Багфикс warning в стилях **IconButton**
-
-## v3.13.0
-
-### Changes
-
-- Депрекейт `buttons` внутри **Modal**
-- Добавляет `footer` для **Modal**
-
-## v3.12.0
-
-### Changes
-
-- Удаляет `isSelected` внутри **Checkbox**
-- Добавляет поддержку `isInvalid` для **Checkbox**
-- Делает опциональным `value` для **Checkbox**
-- Иконка `check-big` стала deprecated
-- Иконки `check`, `check-all` и `minus` обновлены до актуальных из Figma UI Kit'а
-
-## v3.11.0
-
-### Changes
-
-- Добавляет **animations.defaultTransition**
-
-## v3.10.0
-
-### Changes
-
-- Добавлен компонент **IconButton**
-- Компонент **CloseButton** стал deprecated
-
-### Breaking changes
-
-- **Modal** использует **IconButton** вместо **CloseButton**
-- **Toaster** использует **IconButton** вместо **CloseButton**
-
-## v3.9.2
-
-### Changes
-
-- Поднялись версии storybook
-
-## v3.9.1
-
-### Changes
-
-- **WithPopup** для `trigger` добавлен `testId`
-
-## v3.9.0
-
-### Changes
-
-- **Select**:
-  1. Добавлена поддержка для `readonly` опций
-  2. Добавлена типизация для `event` в `onChange`
-- **WithPopup**: добавлен `z-index: 5` для дропдауна
-- **NewMoreMenu**: добавлены твикстайлс для **List** и **WithPopup**
-
-## v3.8.1
-
-### Changes
-
-- **WithPopup** и **NewMoreMenu** добавлена пропса `shouldHideOnScroll`
-
-## v3.8.0
-
-### Changes
-
-- Добавлены компоненты **WithPopup** и **NewMoreMenu** (`floating-ui`)
-- **MoreMenu** deprecated
-
-## v3.7.0
-
-### Changes
-
-- Подключен плагин `eslint-plugin-react-hooks` для линтера
-
-- **FlexibleTable**:
-
-  1. Улучшение код-стайла
-  2. Добавлена пропса `isExpandableRowComponentInitiallyOpen`
-
-- **FlexibleTableCell**: Добавлены классы `loading` и `skeleton` для отрисовки скелетона
-
-### Breaking changes
-
-- **FlexibleTable**:
-
-  1. Удалены типы `ITextAlignment`, `IVerticalAlignment` и `IPosition`
-  2. Удалены классы `skeletonRow` и `skeleton`
-
-### Fixed
-
-- **FlexibleTable**: Исправлен баг, когда при отрисовка скелетона первая колонка таблицы не была sticky
-
-## v3.6.0
-
-- **Select**: Добавлена возможность передавать `defaultOptionLabel` как `ReactNode`
-
-## v3.5.0
-
-### Fixed
-
-- Исправлена ошибка порядка вызова хуков при добавлении/удалении `tweakStyles` во время жизни компонента
-
-## v3.4.0
-
-- **Input**: Добавляет пропс onInput
-
-## v3.3.0
-
-- Улучшение кодстайла
-
-## v3.2.0
-
-- **FlexibleTable** **FlexibleTableCell** **FlexibleTableRow** Добавляет прорс `renderMode`: 'table' | 'divs';
-
-## v3.1.1
-
-- **Status** фикс цветов
-
-## v3.1.0
-
-- Добавлены компоненты **Selector** **Status** **TextButton**
-
-## v3.0.0
-
-- Функции isDateValid / parseStringToDate / и константа DATE_FORMAT -> удалены
-- isInt -> isNumberInteger -> (TE_Helpers)
-- isNotEmpty -> Проверяет только null и undefined (как и должна) -> (TE_Helpers)
-- isEmpty / isStringNotEmpty / addDataTestId / getTestId / getSelectKeyHandler / addClickHandler / createFilter -> (TE_Helpers)
-- В очень многих местах где были ReactNode проперти усилена проверка (теперь не допускаются false и пустые строки)
-- commonTheme -> **common**
-- Подключение провайдера темы теперь через <ThemeProvider theme={u6Theme}>
-- **Tooltip** - добавлены классы .error .info (вместо использования стилевых переменных)
-
-- **Notification** - добавлены классы .error .info .warning .ok .not-ok (вместо использования стилевых переменных)
-
-- **AccountInfo**, **MultiSelectList**, **FilterSelect** так же лишились стилевых переменных (bye bye width)
-
-- **DatePicker** - topPosition / leftPosition - используйте tweakStyles для .popper (marginTop, marginLeft)
-
-- **Checkbox** - alignItems / size / textMargin удалены. отступы через марджин заменены на gap (перепроверьте чекбоксы!)
-
-- Все типы переименованы по паттерну I{TypeName} (все стилевые типы, а так же связанные с темизацией)
-
-- **ThemedPreloader** (изменены tweakStyles -> tweakSvgPreloader + tweakDotsPreloader)
-
-- **FilterWithPeriod** -> tweakSelect -> tweakFilterSelect
-
-- **FlexibleTable** - чайлдовые компоненты переименованы в FlexibleTableRow и FlexibleTableCell. Теперь у них
-  свои tweakStyles: tweakTableRow / tweakTableCell (чайлд для FlexibleTableRow)
-  Классы - root + active + editable / root + sticky + second
-  .row БОЛЬШЕ НЕ РАСПРОСТРАНЯЕТСЯ на .headerRow (раньше они были вместе)
-  classes.horizontallyScrolled - удален. заменено на [data-scrolled]
-  рендер теперь зависит от конфига, а не от первого ряда. т.е. используется не Object.keys(content[0]) а Object.entries(config)
-
-- **ComponentStyles** -> ITweakStyles
-- Проверьте все места 'as Styles', возможно там больше это не нужно
-
-## v2.7.0
-
-### Changes
-
-- **ListItem**: вынесен компонент для отрисовки пункта из списка List
-- **Icon**: добавлены иконки folder, folder-add, presentation
-
-## v2.6.0
-
-### Changes
-
-- **Input**: изменен тип пропса `label` на ReactNode
-
-## v2.5.0
-
-### Changes
-
-- **DatePicker**: добавлен тип для стилей `IDatePickerStyleProps`
-- **Input**: добавлена пропса `shouldAlwaysShowPlaceholder`
-
-## v2.4.0
-
-### Changes
-
-- Изменения по файловой структуре проекта
-
-## v2.3.2
-
-### Changes
-
-- **Modal**: исправляет баг с закрытием модалки по Esc
-
-## v2.3.1
-
-### Changes
-
-- Обновление версии **@true-engineering/true-react-platform-helpers@0.0.5** и функции isNotEmpty
-
-## v2.3.0
-
-### Changes
-
-- **Modal**: расширяет свойства модального окна свойствами для CSSTransition
-
-### Breaking changes
-
-- **Modal**: удалена пропса `onCompletelyHidden`. Вместо неё нужно использовать `onExited`
-
-## v2.2.0
-
-### Changes
-
-- Подключена **@true-engineering/true-react-platform-helpers**
-
-## v2.1.0
-
-### Changes
-
-- **DatePicker**: добавлена пропса `strictParsing`
-- Сохранение JSDoc в `*.d.ts` файлах
-
-### Breaking changes
-
-- **Switch**: удалена пропса `label`. Вместо неё нужно использовать `children`
-
-## v2.0.1
-
-### Fixed
-
-- **Select**: исправлено выделение активной опции в списке
-
-## v0.4.0
-
-**PhoneInput**. Теперь компонент принимает в качестве аргумента объект с информацией о номере телефона IPhoneValue, а не строку.
+# Публикация
 
-**PhoneInputCountryList**. Стили компонента переписаны под актуальный дизайн.
+Слить Pull Request с увеличением версии пакета в файле `package.json` в веткe `master` или `next`.
+Не забыть добавить описание изменений в файл changelog.
 
-Для удобной работы в других проектах добавлены общие хелперы для номера телефона и экспорт справочника телефонных кодов стран.
+Публикация в npm и добавление тега на коммит c версией пакета происходит автоматически в пайплайне.
+Так же автоматически будет создан коммит в репозиторий TE_TrueReactPlatform_Moduled и обновится наш сторибук