@cloud-ru/ds-uikit-product-header 1.5.4-preview-65417497.0 → 2.0.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 2.0.0 (2026-09-29)
+
+### Bug Fixes
+
+- **FF-9088:** align header and service cards with compact density ([e1248e8](https://github.com/cloud-ru-tech/snack-v2/commit/e1248e8ca5d1462df2a5a46b080cc19bb51cf59d))
+- **FF-9088:** use CloudLogoHome in header logo instead of hrGreen brand ([0e73236](https://github.com/cloud-ru-tech/snack-v2/commit/0e73236d3650a2cf2aa3a6a5cbce3efb20aa5472))
+- **FF-9192:** disable dnd measuring on first render ([bcdd411](https://github.com/cloud-ru-tech/snack-v2/commit/bcdd411d3dcd3b32824850399a16e0ac6e2579d7))
+
+### Features
+
+- **FF-9192:** rendering optimizations ([24f6d5b](https://github.com/cloud-ru-tech/snack-v2/commit/24f6d5b02925732340871a2e9bf14a6664533579))
+
+### BREAKING CHANGES
+
+- **FF-9088:** split UserMenu items into top, organization and bottom groups ([91d8a37](https://github.com/cloud-ru-tech/snack-v2/commit/91d8a3717db7bb9e40cc82b21ca33e760cd904a7))
+- **FF-9088:** remove actionsSize from card actions ([bfad613](https://github.com/cloud-ru-tech/snack-v2/commit/bfad613905acd6e7ac0b78db4b62eb4e45d96c29))
+
 ## 1.5.3 (2026-09-28)
 
 **Note:** Version bump only for package @ds/uikit-product-header

package/README.md

@@ -98,13 +98,13 @@ export function PartialSlots() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `breadcrumbs` | `ReactNode` | — |  |
-| `className` | `string` | — |  |
+| `breadcrumbs` | `ReactNode` | — | Слот хлебных крошек. На mobile переносится под основную строку хедера. |
+| `className` | `string` | — | CSS-класс корневого элемента. |
 | `data-test-id` | `string` | — |  |
-| `logo` | `ReactNode` | — |  |
-| `menu` | `ReactNode` | — |  |
-| `select` | `ReactNode` | — |  |
-| `toolbar` | `ReactNode` | — |  |
+| `logo` | `ReactNode` | — | Слот логотипа (крайний левый). |
+| `menu` | `ReactNode` | — | Слот главного меню (слева, после логотипа). |
+| `select` | `ReactNode` | — | Слот селектора (например, выбор облака/организации), после меню. |
+| `toolbar` | `ReactNode` | — | Слот тулбара — правая часть хедера. |
 
 ## MainMenu
 
@@ -292,27 +292,27 @@ function LocalMainMenu() {
 |------|------|---------|-------------|
 | `activeSegmentId` | `string` | — | Активный сегмент правой панели (значение SegmentControl, см. {@link MainMenuSegment.id}). <br/> Не передано — неуправляемое состояние (дефолт — первый сегмент с видимыми карточками). |
 | `defaultWidth` | `number` | — | Ширина дровера, с которой открывается меню (desktop only) |
-| `disabled` | `boolean` | — |  |
+| `disabled` | `boolean` | — | Кнопка открытия меню недоступна для клика. |
 | `draggerTooltip` | `string` | — | Текст подсказки для драггера (desktop only) |
-| `favorite` | `FavoriteProps` | — |  |
-| `leftBottom` | `ReactNode` | — |  |
-| `leftTop` | `ReactNode` | — |  |
+| `favorite` | `FavoriteProps` | — | Избранное. Без пропа группа-предок карточек драга из избранного не активируется. <br/> Избранное. Без пропа секция «Избранное» не отображается. |
+| `leftBottom` | `ReactNode` | — | Слот под пунктами настроек в левой колонке (desktop) / в конце списка (mobile). |
+| `leftTop` | `ReactNode` | — | Слот над поиском в левой колонке (desktop) / над поиском в списке (mobile). |
 | `loading` | `boolean` | — | Флаг загрузки данных |
-| `logo` | `ReactNode` | — |  |
+| `logo` | `ReactNode` | — | Логотип в шапке меню. |
 | `onActiveSegmentChange` | `((segmentId: string) => void)` | — | Колбэк смены активного сегмента правой панели. |
 | `onSegmentExpandedChange` | `((segmentId: string, expandedGroupIds: string[]) => void)` | — | Колбэк при изменении набора раскрытых групп сегмента <br/> (без id синтетической группы избранного). |
 | `onSegmentOrderChange` | `((segmentId: string, orderedGroupIds: string[]) => void)` | — | Колбэк после DnD групп в сегменте (без id синтетической группы избранного). |
 | `onSegmentServiceClick` | `((service: InnerLink, e?: MouseEvent<HTMLElement, MouseEvent>) => void)` | — | Колбэк клика по карточке сервиса в сегменте. |
 | `onWidthChangeEnd` | `((width: number) => void)` | — | Вызывается при окончании изменения ширины дровера (desktop only) |
-| `open` | `boolean` | — |  |
+| `open` | `boolean` | — | Открыто ли меню. <br/> Не передано — состояние открытия неуправляемое (меню само переключает себя по клику на кнопку). |
 | `platformGroups` | `LinksGroup` | — | Платформенные группы (например «Облачные продукты», «Другие продукты»). <br/> Без поиска в сетке карточек **не отображаются**. <br/> С поиском: попадают в результаты при совпадении; порядок — <br/> после совпадений из сегментов без `pinBottomOnSearch`, перед сегментами с `pinBottomOnSearch`. <br/> Обычно `favoritesEnabled: false`; карточки могут быть без `icon` (Avatar по `label`). |
 | `preferences` | `MainMenuPreferencesProps` | — | Настройки меню (модалка по кнопке в тулбаре): описания карточек, цвета групп. <br/> Не передано — кнопка настроек в тулбаре не отображается. |
 | `rightTop` | `ReactNode` | — | Слот над тулбаром правой колонки (например, баннеры) |
-| `search` | `SearchProps` | — |  |
+| `search` | `SearchProps` | — | Поиск по сервисам. Без пропа поисковая строка не отображается. |
 | `searchGroups` | `LinksGroup` | — | Результаты поиска (уже смерженные); в обычном режиме не используются. |
 | `segmentPrefs` | `MainMenuSegmentPrefs` | — | Пользовательские prefs сегментов (порядок / раскрытие групп). <br/> Нет записи для сегмента или omit `order` / `expanded` → uncontrolled для этого поля. |
 | `segments` | `MainMenuSegment` | — | Сегменты правой панели (сетка карточек) — только каталог. <br/> При поиске: совпадения из сегментов без `pinBottomOnSearch` → `platformGroups` → сегменты с `pinBottomOnSearch`. <br/> Если один и тот же {@link InnerLink.id} совпал сразу в нескольких сегментах — остаётся только <br/> первое по этому приоритету вхождение, остальные (и опустевшие после этого группы) не показываются. <br/> При `segments.length > 1` показывается SegmentControl (скрывается во время поиска). <br/> Порядок и раскрытие групп — через `segmentPrefs` и колбэки ниже. |
-| `setOpen` | `((open: boolean) => void)` | — |  |
+| `setOpen` | `((open: boolean) => void)` | — | Колбэк открытия/закрытия меню. |
 | `settingItems` | `InnerLink` \| `MainMenuSettingsItem` | — | Пункты левой колонки (desktop) / нижней части списка (mobile). <br/> Плоский список (`dividerBefore` для разделителей). <br/> Не связан с сегментами правой панели и не меняется при сортировке групп в сегментах. |
 
 ##### Related types
@@ -339,17 +339,17 @@ function LocalMainMenu() {
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `aliases` | `string[]` | — | Синонимы для fuzzy-поиска. |
-| `badge` | `CardServiceLightProps` \| `PromoTagPredefinedBaseProps` | — |  |
+| `badge` | `CardServiceLightProps` \| `PromoTagPredefinedBaseProps` | — | Промо-тег карточки. |
 | `description` | `string \| undefined` | — | Краткое описание сервиса — отображается при включённом переключателе «Описание». |
-| `disabled` | `boolean \| undefined` | — |  |
+| `disabled` | `boolean \| undefined` | — | Карточка недоступна для клика/drag и визуально приглушена. |
 | `favoritesEnabled` | `boolean \| undefined` | — | Разрешено ли добавление карточки в избранное. default=true - разрешено |
-| `hidden` | `boolean \| undefined` | — |  |
-| `href` | `string \| undefined` | — |  |
+| `hidden` | `boolean \| undefined` | — | Карточка скрыта (не рендерится, но остаётся в данных — например, для поиска). |
+| `href` | `string \| undefined` | — | Ссылка карточки (рендерится как `<a>`). |
 | `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — | Иконка карточки. |
 | `id` | `string` | — | Уникальный идентификатор карточки (также используется в избранном и при поиске). <br/> Один и тот же сервис может быть представлен в разных сегментах с разной <br/> детализацией (простая карточка в общем каталоге и раскрытая с вложенными <br/> сервисами версия в другом сегменте) — в этом случае обеим версиям задаётся <br/> общий `id`. При поиске из совпадений с одинаковым `id` в разных сегментах <br/> остаётся только первое по приоритету сегментов (см. <br/> {@link <br/> MainMenuProps.segments <br/> } <br/> ). |
 | `items` | `InnerLink` | — | Вложенные сервисы подкатегории. <br/> При наличии карточка раскрывается аккордеоном: в свёрнутом виде — обычная карточка <br/> с кнопкой раскрытия, в развёрнутом — заголовок <br/> {@link <br/> TitleClickable <br/> } <br/> и сетка вложенных сервисов. |
 | `label` | `string` | — | Заголовок карточки. |
-| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — |  |
+| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — | Колбэк клика по карточке. |
 | `viewMode` | `"expandable"` \| `"expanded"` \| `"flat-link"` \| `"group-title-only"` | — | Режим отображения карточки. default='expandable'. <br/> - `'expandable'` — подкатегория при наличии реальных <br/> {@link <br/> items <br/> } <br/> : заголовок <br/> {@link <br/> TitleClickable <br/> } <br/> с шевроном и сетка вложенных сервисов (раскрытие/схлопывание — <br/> см. <br/> {@link <br/> expandableEnabled <br/> } <br/> ). Без `items` — обычная карточка сервиса. <br/> - `'group-title-only'` — заголовок подкатегории ( <br/> {@link <br/> TitleClickable <br/> } <br/> с шевроном) без <br/> раскрываемого тела, даже если `items` заданы: карточка ведёт себя как обычная ссылка. <br/> Полезно для группы, чьи вложенные сервисы показываются на отдельной странице. <br/> - `'flat-link'` — всегда обычная карточка сервиса, даже если `items` заданы. |
 
 - `InnerLinkViewMode` = `"expandable"` \| `"expanded"` \| `"flat-link"` \| `"group-title-only"`
@@ -361,13 +361,13 @@ function LocalMainMenu() {
 | `aliases` | `string[] \| undefined` | — | Синонимы заголовка группы для fuzzy-поиска. |
 | `blockColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"primary"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Цвет блока группы. |
 | `favoritesEnabled` | `boolean \| undefined` | — | Разрешено ли добавление карточек группы в избранное. |
-| `hidden` | `boolean \| undefined` | — |  |
-| `highlight` | `boolean \| undefined` | — | Визуальное выделение группы |
-| `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — |  |
+| `hidden` | `boolean \| undefined` | — | Группа скрыта (не рендерится, но остаётся в данных — например, для поиска). |
+| `highlight` | `boolean \| undefined` | — | Визуальное выделение группы. |
+| `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — | Иконка группы. |
 | `id` | `string` | — | Уникальный идентификатор группы (якорь скролла, поиск по id). |
 | `items` | `InnerLink` | — | Карточки сервисов или ссылок внутри группы. |
 | `label` | `LinksGroupTitle` \| `TitleClickable` \| `TitleStatic` | — | Заголовок группы в сетке карточек и в боковой навигации. |
-| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — |  |
+| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — | Колбэк клика по заголовку группы. |
 
 - `LinksGroupBlockColor` = `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"primary"` \| `"red"` \| `"violet"` \| `"yellow"`
 
@@ -404,38 +404,38 @@ function LocalMainMenu() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `divider` | `"after"` \| `"before"` | — |  |
-| `hidden` | `boolean \| undefined` | — |  |
-| `href` | `string \| undefined` | — |  |
+| `divider` | `"after"` \| `"before"` | — | Разделитель до/после пункта. |
+| `hidden` | `boolean \| undefined` | — | Карточка скрыта (не рендерится, но остаётся в данных — например, для поиска). |
+| `href` | `string \| undefined` | — | Ссылка карточки (рендерится как `<a>`). |
 | `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — | Иконка карточки. |
 | `id` | `string` | — | Уникальный идентификатор карточки (также используется в избранном и при поиске). <br/> Один и тот же сервис может быть представлен в разных сегментах с разной <br/> детализацией (простая карточка в общем каталоге и раскрытая с вложенными <br/> сервисами версия в другом сегменте) — в этом случае обеим версиям задаётся <br/> общий `id`. При поиске из совпадений с одинаковым `id` в разных сегментах <br/> остаётся только первое по приоритету сегментов (см. <br/> {@link <br/> MainMenuProps.segments <br/> } <br/> ). |
 | `label` | `string` | — | Заголовок карточки. |
-| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — |  |
+| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — | Колбэк клика по карточке. |
 
 **MainMenuToggleProps**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `onChange` | `(value: boolean) => void` | — |  |
-| `value` | `boolean` | — |  |
+| `onChange` | `(value: boolean) => void` | — | Колбэк изменения значения переключателя. |
+| `value` | `boolean` | — | Текущее значение переключателя. |
 
 **SearchProps**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `onBlur` | `FocusEventHandler<HTMLInputElement> \| undefined` | — | Колбек обработки потери фокуса |
-| `onChange` | `(value: string) => void` | — |  |
+| `onChange` | `(value: string) => void` | — | Колбэк изменения значения поисковой строки. |
 | `onFocus` | `FocusEventHandler<HTMLInputElement> \| undefined` | — | Колбек обработки получения фокуса |
-| `onSearchNoResult` | `((value: string) => void) \| undefined` | — |  |
-| `value` | `string` | — |  |
+| `onSearchNoResult` | `((value: string) => void) \| undefined` | — | Колбэк вызывается, когда поиск по текущему значению не дал результатов. |
+| `value` | `string` | — | Текущее значение поисковой строки. |
 
 **TitleClickable**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `href` | `string \| undefined` | — |  |
-| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — |  |
-| `text` | `string` | — |  |
+| `href` | `string \| undefined` | — | Ссылка заголовка (рендерится как `<a>`). |
+| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — | Колбэк клика по заголовку. |
+| `text` | `string` | — | Текст заголовка. |
 
 **TitleStatic**
 
@@ -443,7 +443,7 @@ function LocalMainMenu() {
 |------|------|---------|-------------|
 | `href` | `undefined` | — |  |
 | `onClick` | `undefined` | — |  |
-| `text` | `string` | — |  |
+| `text` | `string` | — | Текст заголовка. |
 
 ### Смотри также
 
@@ -466,27 +466,27 @@ import { MainMenu, MenuMobile } from '@cloud-ru/ds-uikit-product-header';
 |------|------|---------|-------------|
 | `activeSegmentId` | `string` | — | Активный сегмент правой панели (значение SegmentControl, см. {@link MainMenuSegment.id}). <br/> Не передано — неуправляемое состояние (дефолт — первый сегмент с видимыми карточками). |
 | `defaultWidth` | `number` | — | Ширина дровера, с которой открывается меню (desktop only) |
-| `disabled` | `boolean` | — |  |
+| `disabled` | `boolean` | — | Кнопка открытия меню недоступна для клика. |
 | `draggerTooltip` | `string` | — | Текст подсказки для драггера (desktop only) |
-| `favorite` | `FavoriteProps` | — |  |
-| `leftBottom` | `ReactNode` | — |  |
-| `leftTop` | `ReactNode` | — |  |
+| `favorite` | `FavoriteProps` | — | Избранное. Без пропа группа-предок карточек драга из избранного не активируется. <br/> Избранное. Без пропа секция «Избранное» не отображается. |
+| `leftBottom` | `ReactNode` | — | Слот под пунктами настроек в левой колонке (desktop) / в конце списка (mobile). |
+| `leftTop` | `ReactNode` | — | Слот над поиском в левой колонке (desktop) / над поиском в списке (mobile). |
 | `loading` | `boolean` | — | Флаг загрузки данных |
-| `logo` | `ReactNode` | — |  |
+| `logo` | `ReactNode` | — | Логотип в шапке меню. |
 | `onActiveSegmentChange` | `((segmentId: string) => void)` | — | Колбэк смены активного сегмента правой панели. |
 | `onSegmentExpandedChange` | `((segmentId: string, expandedGroupIds: string[]) => void)` | — | Колбэк при изменении набора раскрытых групп сегмента <br/> (без id синтетической группы избранного). |
 | `onSegmentOrderChange` | `((segmentId: string, orderedGroupIds: string[]) => void)` | — | Колбэк после DnD групп в сегменте (без id синтетической группы избранного). |
 | `onSegmentServiceClick` | `((service: InnerLink, e?: MouseEvent<HTMLElement, MouseEvent>) => void)` | — | Колбэк клика по карточке сервиса в сегменте. |
 | `onWidthChangeEnd` | `((width: number) => void)` | — | Вызывается при окончании изменения ширины дровера (desktop only) |
-| `open` | `boolean` | — |  |
+| `open` | `boolean` | `false` | Открыто ли меню. <br/> Не передано — состояние открытия неуправляемое (меню само переключает себя по клику на кнопку). |
 | `platformGroups` | `LinksGroup` | — | Платформенные группы (например «Облачные продукты», «Другие продукты»). <br/> Без поиска в сетке карточек **не отображаются**. <br/> С поиском: попадают в результаты при совпадении; порядок — <br/> после совпадений из сегментов без `pinBottomOnSearch`, перед сегментами с `pinBottomOnSearch`. <br/> Обычно `favoritesEnabled: false`; карточки могут быть без `icon` (Avatar по `label`). |
 | `preferences` | `MainMenuPreferencesProps` | — | Настройки меню (модалка по кнопке в тулбаре): описания карточек, цвета групп. <br/> Не передано — кнопка настроек в тулбаре не отображается. |
 | `rightTop` | `ReactNode` | — | Слот над тулбаром правой колонки (например, баннеры) |
-| `search` | `SearchProps` | — |  |
+| `search` | `SearchProps` | — | Поиск по сервисам. Без пропа поисковая строка не отображается. |
 | `searchGroups` | `LinksGroup` | — | Результаты поиска (уже смерженные); в обычном режиме не используются. |
 | `segmentPrefs` | `MainMenuSegmentPrefs` | — | Пользовательские prefs сегментов (порядок / раскрытие групп). <br/> Нет записи для сегмента или omit `order` / `expanded` → uncontrolled для этого поля. |
 | `segments` | `MainMenuSegment` | — | Сегменты правой панели (сетка карточек) — только каталог. <br/> При поиске: совпадения из сегментов без `pinBottomOnSearch` → `platformGroups` → сегменты с `pinBottomOnSearch`. <br/> Если один и тот же {@link InnerLink.id} совпал сразу в нескольких сегментах — остаётся только <br/> первое по этому приоритету вхождение, остальные (и опустевшие после этого группы) не показываются. <br/> При `segments.length > 1` показывается SegmentControl (скрывается во время поиска). <br/> Порядок и раскрытие групп — через `segmentPrefs` и колбэки ниже. |
-| `setOpen` | `((open: boolean) => void)` | — |  |
+| `setOpen` | `((open: boolean) => void)` | — | Колбэк открытия/закрытия меню. |
 | `settingItems` | `InnerLink` \| `MainMenuSettingsItem` | — | Пункты левой колонки (desktop) / нижней части списка (mobile). <br/> Плоский список (`dividerBefore` для разделителей). <br/> Не связан с сегментами правой панели и не меняется при сортировке групп в сегментах. |
 
 ##### Related types
@@ -513,17 +513,17 @@ import { MainMenu, MenuMobile } from '@cloud-ru/ds-uikit-product-header';
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `aliases` | `string[]` | — | Синонимы для fuzzy-поиска. |
-| `badge` | `CardServiceLightProps` \| `PromoTagPredefinedBaseProps` | — |  |
+| `badge` | `CardServiceLightProps` \| `PromoTagPredefinedBaseProps` | — | Промо-тег карточки. |
 | `description` | `string \| undefined` | — | Краткое описание сервиса — отображается при включённом переключателе «Описание». |
-| `disabled` | `boolean \| undefined` | — |  |
+| `disabled` | `boolean \| undefined` | — | Карточка недоступна для клика/drag и визуально приглушена. |
 | `favoritesEnabled` | `boolean \| undefined` | — | Разрешено ли добавление карточки в избранное. default=true - разрешено |
-| `hidden` | `boolean \| undefined` | — |  |
-| `href` | `string \| undefined` | — |  |
+| `hidden` | `boolean \| undefined` | — | Карточка скрыта (не рендерится, но остаётся в данных — например, для поиска). |
+| `href` | `string \| undefined` | — | Ссылка карточки (рендерится как `<a>`). |
 | `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — | Иконка карточки. |
 | `id` | `string` | — | Уникальный идентификатор карточки (также используется в избранном и при поиске). <br/> Один и тот же сервис может быть представлен в разных сегментах с разной <br/> детализацией (простая карточка в общем каталоге и раскрытая с вложенными <br/> сервисами версия в другом сегменте) — в этом случае обеим версиям задаётся <br/> общий `id`. При поиске из совпадений с одинаковым `id` в разных сегментах <br/> остаётся только первое по приоритету сегментов (см. <br/> {@link <br/> MainMenuProps.segments <br/> } <br/> ). |
 | `items` | `InnerLink` | — | Вложенные сервисы подкатегории. <br/> При наличии карточка раскрывается аккордеоном: в свёрнутом виде — обычная карточка <br/> с кнопкой раскрытия, в развёрнутом — заголовок <br/> {@link <br/> TitleClickable <br/> } <br/> и сетка вложенных сервисов. |
 | `label` | `string` | — | Заголовок карточки. |
-| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — |  |
+| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — | Колбэк клика по карточке. |
 | `viewMode` | `"expandable"` \| `"expanded"` \| `"flat-link"` \| `"group-title-only"` | — | Режим отображения карточки. default='expandable'. <br/> - `'expandable'` — подкатегория при наличии реальных <br/> {@link <br/> items <br/> } <br/> : заголовок <br/> {@link <br/> TitleClickable <br/> } <br/> с шевроном и сетка вложенных сервисов (раскрытие/схлопывание — <br/> см. <br/> {@link <br/> expandableEnabled <br/> } <br/> ). Без `items` — обычная карточка сервиса. <br/> - `'group-title-only'` — заголовок подкатегории ( <br/> {@link <br/> TitleClickable <br/> } <br/> с шевроном) без <br/> раскрываемого тела, даже если `items` заданы: карточка ведёт себя как обычная ссылка. <br/> Полезно для группы, чьи вложенные сервисы показываются на отдельной странице. <br/> - `'flat-link'` — всегда обычная карточка сервиса, даже если `items` заданы. |
 
 - `InnerLinkViewMode` = `"expandable"` \| `"expanded"` \| `"flat-link"` \| `"group-title-only"`
@@ -535,13 +535,13 @@ import { MainMenu, MenuMobile } from '@cloud-ru/ds-uikit-product-header';
 | `aliases` | `string[] \| undefined` | — | Синонимы заголовка группы для fuzzy-поиска. |
 | `blockColor` | `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"primary"` \| `"red"` \| `"violet"` \| `"yellow"` | — | Цвет блока группы. |
 | `favoritesEnabled` | `boolean \| undefined` | — | Разрешено ли добавление карточек группы в избранное. |
-| `hidden` | `boolean \| undefined` | — |  |
-| `highlight` | `boolean \| undefined` | — | Визуальное выделение группы |
-| `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — |  |
+| `hidden` | `boolean \| undefined` | — | Группа скрыта (не рендерится, но остаётся в данных — например, для поиска). |
+| `highlight` | `boolean \| undefined` | — | Визуальное выделение группы. |
+| `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — | Иконка группы. |
 | `id` | `string` | — | Уникальный идентификатор группы (якорь скролла, поиск по id). |
 | `items` | `InnerLink` | — | Карточки сервисов или ссылок внутри группы. |
 | `label` | `LinksGroupTitle` \| `TitleClickable` \| `TitleStatic` | — | Заголовок группы в сетке карточек и в боковой навигации. |
-| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — |  |
+| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — | Колбэк клика по заголовку группы. |
 
 - `LinksGroupBlockColor` = `"blue"` \| `"green"` \| `"neutral"` \| `"orange"` \| `"pink"` \| `"primary"` \| `"red"` \| `"violet"` \| `"yellow"`
 
@@ -578,38 +578,38 @@ import { MainMenu, MenuMobile } from '@cloud-ru/ds-uikit-product-header';
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `divider` | `"after"` \| `"before"` | — |  |
-| `hidden` | `boolean \| undefined` | — |  |
-| `href` | `string \| undefined` | — |  |
+| `divider` | `"after"` \| `"before"` | — | Разделитель до/после пункта. |
+| `hidden` | `boolean \| undefined` | — | Карточка скрыта (не рендерится, но остаётся в данных — например, для поиска). |
+| `href` | `string \| undefined` | — | Ссылка карточки (рендерится как `<a>`). |
 | `icon` | `JSXElementConstructor<{ size?: number; className?: string; }> \| undefined` | — | Иконка карточки. |
 | `id` | `string` | — | Уникальный идентификатор карточки (также используется в избранном и при поиске). <br/> Один и тот же сервис может быть представлен в разных сегментах с разной <br/> детализацией (простая карточка в общем каталоге и раскрытая с вложенными <br/> сервисами версия в другом сегменте) — в этом случае обеим версиям задаётся <br/> общий `id`. При поиске из совпадений с одинаковым `id` в разных сегментах <br/> остаётся только первое по приоритету сегментов (см. <br/> {@link <br/> MainMenuProps.segments <br/> } <br/> ). |
 | `label` | `string` | — | Заголовок карточки. |
-| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — |  |
+| `onClick` | `(e?: MouseEvent<HTMLElement>) => void` | — | Колбэк клика по карточке. |
 
 **MainMenuToggleProps**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `onChange` | `(value: boolean) => void` | — |  |
-| `value` | `boolean` | — |  |
+| `onChange` | `(value: boolean) => void` | — | Колбэк изменения значения переключателя. |
+| `value` | `boolean` | — | Текущее значение переключателя. |
 
 **SearchProps**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `onBlur` | `FocusEventHandler<HTMLInputElement> \| undefined` | — | Колбек обработки потери фокуса |
-| `onChange` | `(value: string) => void` | — |  |
+| `onChange` | `(value: string) => void` | — | Колбэк изменения значения поисковой строки. |
 | `onFocus` | `FocusEventHandler<HTMLInputElement> \| undefined` | — | Колбек обработки получения фокуса |
-| `onSearchNoResult` | `((value: string) => void) \| undefined` | — |  |
-| `value` | `string` | — |  |
+| `onSearchNoResult` | `((value: string) => void) \| undefined` | — | Колбэк вызывается, когда поиск по текущему значению не дал результатов. |
+| `value` | `string` | — | Текущее значение поисковой строки. |
 
 **TitleClickable**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `href` | `string \| undefined` | — |  |
-| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — |  |
-| `text` | `string` | — |  |
+| `href` | `string \| undefined` | — | Ссылка заголовка (рендерится как `<a>`). |
+| `onClick` | `((e?: MouseEvent<HTMLElement>) => void) \| undefined` | — | Колбэк клика по заголовку. |
+| `text` | `string` | — | Текст заголовка. |
 
 **TitleStatic**
 
@@ -617,7 +617,7 @@ import { MainMenu, MenuMobile } from '@cloud-ru/ds-uikit-product-header';
 |------|------|---------|-------------|
 | `href` | `undefined` | — |  |
 | `onClick` | `undefined` | — |  |
-| `text` | `string` | — |  |
+| `text` | `string` | — | Текст заголовка. |
 
 ### Адаптивность
 
@@ -694,16 +694,16 @@ export function ControlledTheme() {
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `bottomItems` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `DroplistProps` \| `ScrollProps` | — | Пункты перед «Выйти из аккаунта». На desktop закреплены снизу |
-| `onClick` | `(() => void)` | — |  |
-| `onLogout` | `(() => void)` | — |  |
-| `open` | `boolean` | — |  |
+| `onClick` | `(() => void)` | — | Колбэк клика по кнопке-триггеру. |
+| `onLogout` | `(() => void)` | — | Колбэк клика по пункту «Выйти». |
+| `open` | `boolean` | — | Открыто ли меню. <br/> Не передано — состояние открытия неуправляемое (меню само переключает себя по клику на кнопку). |
 | `organizationItems` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `DroplistProps` \| `ScrollProps` | — | Список организаций. На desktop — единственная прокручиваемая часть меню |
-| `profile` | `UserProfileProps` | `{}` |  |
-| `setOpen` | `((open: boolean) => void)` | — |  |
-| `settingItems` | `BaseItemProps` | — |  |
-| `theme` | `ThemeProps` | — |  |
+| `profile` | `UserProfileProps` | `{}` | Профиль пользователя (имя, email, счётчик приглашений). |
+| `setOpen` | `((open: boolean) => void)` | — | Колбэк открытия/закрытия меню. |
+| `settingItems` | `BaseItemProps` | — | Пункты настроек в нижней части меню. |
+| `theme` | `ThemeProps` | — | Переключатель темы в меню. Без пропа не отображается. |
 | `topItems` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `DroplistProps` \| `ScrollProps` | — | Пункты после темы. На desktop закреплены сверху вместе с профилем и темой |
-| `triggerTooltip` | `string` | — |  |
+| `triggerTooltip` | `string` | — | Текст подсказки для кнопки-триггера. |
 
 ##### Related types
 
@@ -713,18 +713,18 @@ export function ControlledTheme() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `onChange` | `((themeMode: ThemeMode) => void) \| undefined` | — |  |
-| `value` | `"dark"` \| `"light"` \| `"system"` | — |  |
+| `onChange` | `((themeMode: ThemeMode) => void) \| undefined` | — | Колбэк изменения режима темы. |
+| `value` | `"dark"` \| `"light"` \| `"system"` | — | Текущий режим темы. Без пропа переключатель темы в меню не отображается. |
 
 **UserProfileProps**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `email` | `string \| undefined` | — |  |
-| `fullName` | `string \| undefined` | — |  |
-| `inviteCount` | `number \| undefined` | — |  |
-| `itemWrapRender` | `((node: ReactNode) => ReactNode) \| undefined` | — |  |
-| `onClick` | `((e: MouseEvent<HTMLElement>) => void) \| undefined` | — |  |
+| `email` | `string \| undefined` | — | Email пользователя. |
+| `fullName` | `string \| undefined` | — | Полное имя пользователя. Отображается в аватаре (первые буквы) и в пункте профиля меню. |
+| `inviteCount` | `number \| undefined` | — | Число активных приглашений — отображается счётчиком на кнопке-триггере меню. |
+| `itemWrapRender` | `((node: ReactNode) => ReactNode) \| undefined` | — | Оборачивает содержимое пункта профиля — например, ссылкой или дополнительной разметкой. |
+| `onClick` | `((e: MouseEvent<HTMLElement>) => void) \| undefined` | — | Колбэк клика по пункту профиля. |
 
 ## Logo
 
@@ -775,14 +775,14 @@ export function WithMode() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `className` | `string` | — |  |
+| `className` | `string` | — | CSS-класс корневого элемента. |
 | `data-test-id` | `string` | — |  |
-| `href` | `string` | — |  |
-| `loading` | `boolean` | — |  |
-| `mode` | `"develop"` \| `"hybrid"` \| `"prod"` \| `"stage"` | — |  |
-| `onClick` | `MouseEventHandler<HTMLAnchorElement>` | — |  |
-| `path` | `string` | — |  |
-| `tooltip` | `TooltipProps` | — |  |
+| `href` | `string` | — | Ссылка логотипа. |
+| `loading` | `boolean` | — | Флаг загрузки — логотип показывается в состоянии загрузки кнопки. |
+| `mode` | `"develop"` \| `"hybrid"` \| `"prod"` \| `"stage"` | — | Режим окружения — отображается промо-тегом рядом с дефолтной иконкой (не для `'prod'`). |
+| `onClick` | `MouseEventHandler<HTMLAnchorElement>` | — | Колбэк клика по логотипу. |
+| `path` | `string` | — | Путь до кастомного изображения логотипа. Без пропа (или при ошибке загрузки) — дефолтная иконка. |
+| `tooltip` | `TooltipProps` | — | Настройки тултипа логотипа. |
 
 ##### Related types
 
@@ -823,4 +823,4 @@ export function Basic() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `items` | `BreadcrumbsProps` \| `Item` | — |  |
+| `items` | `BreadcrumbsProps` \| `Item` | — | Пункты хлебных крошек. |

package/dist/cjs/components/HeaderButton/HeaderButton.d.ts

@@ -4,6 +4,7 @@ import { ElementType } from 'react';
 export type HeaderButtonProps<T extends ElementType = 'button'> = Omit<ButtonProps<T>, 'size' | 'appearance' | 'view'> & {
     /** Настройки тултипа. `placement` и `disableSpanWrapper` зафиксированы под анатомию хедера */
     tooltip?: Omit<TooltipProps, 'placement'>;
+    /** Мобильная раскладка — тултип не показывается (на mobile нет hover). */
     isMobile?: boolean;
 };
 /**

package/dist/cjs/components/HeaderLayout/HeaderLayout.d.ts

@@ -1,11 +1,17 @@
 import { WithSupportProps } from '@cloud-ru/ds-utils';
 import { ReactNode } from 'react';
 export type HeaderLayoutProps = WithSupportProps<{
+    /** CSS-класс корневого элемента. */
     className?: string;
+    /** Слот главного меню (слева, после логотипа). */
     menu?: ReactNode;
+    /** Слот логотипа (крайний левый). */
     logo?: ReactNode;
+    /** Слот селектора (например, выбор облака/организации), после меню. */
     select?: ReactNode;
+    /** Слот хлебных крошек. На mobile переносится под основную строку хедера. */
     breadcrumbs?: ReactNode;
+    /** Слот тулбара — правая часть хедера. */
     toolbar?: ReactNode;
 }>;
 export declare function HeaderLayout({ menu, logo, select, breadcrumbs, toolbar, className, ...rest }: HeaderLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/components/Logo/Logo.d.ts

@@ -3,12 +3,19 @@ import { WithSupportProps } from '@cloud-ru/ds-utils';
 import { MouseEventHandler } from 'react';
 import { HeaderLogoMode } from './constants';
 export type LogoProps = WithSupportProps<{
+    /** Флаг загрузки — логотип показывается в состоянии загрузки кнопки. */
     loading?: boolean;
+    /** Путь до кастомного изображения логотипа. Без пропа (или при ошибке загрузки) — дефолтная иконка. */
     path?: string;
+    /** Режим окружения — отображается промо-тегом рядом с дефолтной иконкой (не для `'prod'`). */
     mode?: HeaderLogoMode;
+    /** Ссылка логотипа. */
     href: string;
+    /** Колбэк клика по логотипу. */
     onClick?: MouseEventHandler<HTMLAnchorElement>;
+    /** CSS-класс корневого элемента. */
     className?: string;
+    /** Настройки тултипа логотипа. */
     tooltip?: TooltipProps;
 }>;
 export declare function Logo({ path, loading, mode, href, onClick, className, tooltip, ...rest }: LogoProps): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/components/MainMenu/MainMenu.js

@@ -14,13 +14,16 @@ const MenuMobile_1 = require("./helperComponents/MenuMobile");
 function MainMenu({ open: openProp, setOpen: setOpenProp, settingItems, platformGroups, logo, leftTop, leftBottom, rightTop, segments, segmentPrefs, activeSegmentId, onActiveSegmentChange, onSegmentOrderChange, onSegmentExpandedChange, onSegmentServiceClick, favorite, search, preferences, disabled, defaultWidth, onWidthChangeEnd, draggerTooltip, loading, }) {
     const { t } = locale_1.headerLocale.useTranslations();
     const [open = false, setOpen] = (0, utils_1.useValueControl)({ value: openProp, onChange: setOpenProp });
+    const searchValue = search?.value;
+    const onSearchChange = search?.onChange;
     (0, react_1.useEffect)(() => {
-        if (!open && search?.value)
-            search?.onChange('');
-    }, [open, search]);
+        if (!open && searchValue)
+            onSearchChange?.('');
+    }, [open, searchValue, onSearchChange]);
+    const handleOpen = (0, react_1.useCallback)(() => {
+        setOpen(true);
+    }, [setOpen]);
     const isMobile = (0, useMobileLayout_1.useMobileLayout)();
     const MenuComponent = isMobile ? MenuMobile_1.MenuMobile : MenuDesktop_1.MenuDesktop;
-    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(HeaderButton_1.HeaderButton, { tooltip: open ? undefined : { tip: t('services') }, isMobile: isMobile, disabled: disabled, icon: (0, jsx_runtime_1.jsx)(product_1.MainMenuSVG, {}), onClick: () => {
-                    setOpen(true);
-                }, "data-test-id": constants_1.TEST_IDS.mainMenu.drawerButton }), (0, jsx_runtime_1.jsx)(MenuComponent, { settingItems: settingItems, segments: segments, segmentPrefs: segmentPrefs, activeSegmentId: activeSegmentId, onActiveSegmentChange: onActiveSegmentChange, onSegmentOrderChange: onSegmentOrderChange, onSegmentExpandedChange: onSegmentExpandedChange, onSegmentServiceClick: onSegmentServiceClick, platformGroups: platformGroups, search: search, logo: logo, leftTop: leftTop, leftBottom: leftBottom, rightTop: rightTop, favorite: favorite, open: open, setOpen: setOpen, preferences: preferences, defaultWidth: defaultWidth, onWidthChangeEnd: onWidthChangeEnd, draggerTooltip: draggerTooltip, loading: loading })] }));
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(HeaderButton_1.HeaderButton, { tooltip: open ? undefined : { tip: t('services') }, isMobile: isMobile, disabled: disabled, icon: (0, jsx_runtime_1.jsx)(product_1.MainMenuSVG, {}), onClick: handleOpen, "data-test-id": constants_1.TEST_IDS.mainMenu.drawerButton }), (0, jsx_runtime_1.jsx)(MenuComponent, { settingItems: settingItems, segments: segments, segmentPrefs: segmentPrefs, activeSegmentId: activeSegmentId, onActiveSegmentChange: onActiveSegmentChange, onSegmentOrderChange: onSegmentOrderChange, onSegmentExpandedChange: onSegmentExpandedChange, onSegmentServiceClick: onSegmentServiceClick, platformGroups: platformGroups, search: search, logo: logo, leftTop: leftTop, leftBottom: leftBottom, rightTop: rightTop, favorite: favorite, open: open, setOpen: setOpen, preferences: preferences, defaultWidth: defaultWidth, onWidthChangeEnd: onWidthChangeEnd, draggerTooltip: draggerTooltip, loading: loading })] }));
 }

package/dist/cjs/components/MainMenu/helperComponents/Banners/MenuBanner.js

@@ -22,5 +22,5 @@ function MenuBanner({ title, promoTag, afterTitle, onClose, className, href = '#
         e.stopPropagation();
         onClose?.(e);
     }, [onClose]);
-    return ((0, jsx_runtime_1.jsx)(card_1.Card, { as: 'a', href: href, radius: 'l', view: 'simple', className: (0, classnames_1.default)(styles_module_scss_1.default.root, className), "data-test-id": dataTestId ?? constants_1.MENU_BANNER_TEST_IDS.root, ...rest, children: (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.contentRow, children: [(0, jsx_runtime_1.jsxs)("span", { className: styles_module_scss_1.default.titleWrapper, children: [(0, jsx_runtime_1.jsx)(typography_1.Typography, { as: 'span', variant: 'body', size: 'm', className: styles_module_scss_1.default.title, "data-test-id": constants_1.MENU_BANNER_TEST_IDS.title, children: title }), promoTag && ((0, jsx_runtime_1.jsx)(promo_tag_1.PromoTag, { ...promoTag, className: styles_module_scss_1.default.promoTag, roleAppearance: promo_tag_1.ROLE_APPEARANCE.Decor, size: promo_tag_1.SIZE.Xs, "data-test-id": constants_1.MENU_BANNER_TEST_IDS.promoTag }))] }), afterTitle && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.afterTitle, "data-test-id": constants_1.MENU_BANNER_TEST_IDS.afterTitle, children: afterTitle })), onClose && ((0, jsx_runtime_1.jsx)(button_1.Button, { className: styles_module_scss_1.default.closeButton, view: 'elevated', appearance: 'neutral', size: 's', icon: (0, jsx_runtime_1.jsx)(system_1.CrossSVG, { size: 16 }), onClick: handleClose, "aria-label": t('close'), "data-test-id": constants_1.MENU_BANNER_TEST_IDS.close }))] }) }));
+    return ((0, jsx_runtime_1.jsx)(card_1.Card, { as: 'a', href: href, radius: 'l', view: 'simple', className: (0, classnames_1.default)(styles_module_scss_1.default.root, className), "data-test-id": dataTestId ?? constants_1.MENU_BANNER_TEST_IDS.root, ...rest, children: (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.contentRow, children: [(0, jsx_runtime_1.jsxs)("span", { className: styles_module_scss_1.default.titleWrapper, children: [(0, jsx_runtime_1.jsx)(typography_1.Typography, { as: 'span', variant: 'body', size: 'm', className: styles_module_scss_1.default.title, "data-test-id": constants_1.MENU_BANNER_TEST_IDS.title, children: title }), promoTag && ((0, jsx_runtime_1.jsx)(promo_tag_1.PromoTag, { ...promoTag, className: styles_module_scss_1.default.promoTag, roleAppearance: promo_tag_1.ROLE_APPEARANCE.Decor, size: promo_tag_1.SIZE.Xs, "data-test-id": constants_1.MENU_BANNER_TEST_IDS.promoTag }))] }), afterTitle && ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.afterTitle, "data-test-id": constants_1.MENU_BANNER_TEST_IDS.afterTitle, children: afterTitle })), onClose && ((0, jsx_runtime_1.jsx)(button_1.Button, { className: styles_module_scss_1.default.closeButton, view: 'elevated', appearance: 'neutral', size: 's', icon: (0, jsx_runtime_1.jsx)(system_1.CrossSVG, {}), onClick: handleClose, "aria-label": t('close'), "data-test-id": constants_1.MENU_BANNER_TEST_IDS.close }))] }) }));
 }

package/dist/cjs/components/MainMenu/helperComponents/Content/Content.d.ts

@@ -40,6 +40,7 @@ export type ContentProps = {
      * Колбэк клика по карточке сервиса в сегменте.
      */
     onSegmentServiceClick?(service: InnerLink, e?: MouseEvent<HTMLElement>): void;
+    /** Избранное. Без пропа группа-предок карточек драга из избранного не активируется. */
     favorite?: FavoriteProps;
     /**
      * Настройки меню (модалка по кнопке в тулбаре): описания карточек, цвета групп.
@@ -47,12 +48,17 @@ export type ContentProps = {
      * Не передано — кнопка настроек в тулбаре не отображается.
      */
     preferences?: MainMenuPreferencesProps;
+    /** Текущее значение поисковой строки — переключает контент между каталогом и результатами поиска. */
     searchValue?: string;
+    /** Слот поисковой строки — рендерится над контентом. */
     search?: ReactNode;
     /** Слот над тулбаром правой колонки (например, баннеры) */
     rightTop?: ReactNode;
+    /** Слот под сеткой карточек. */
     footer?: ReactNode;
+    /** Мобильная раскладка. */
     isMobile?: boolean;
+    /** CSS-класс корневого элемента. */
     className?: string;
     /** Флаг загрузки данных */
     loading?: boolean;