@olddevs/ui 4.1.1 → 4.2.0

package/docs/components/overlays/menu.md

@@ -14,7 +14,10 @@ story: src/components/overlays/Menu.stories.tsx
 `Menu` — составное меню действий, открываемое `MenuTrigger`. Внутри `MenuTrigger`
 используйте специальный `MenuButton`, а не обычный `Button`: только он читает
 `ButtonContext` react-aria. Меню подходит для разнородных команд, разделов, выбранных режимов и
-подменю; не для выбора значения поля.
+подменю; не для выбора значения поля. Вложенный `Menu` в `SubmenuTrigger` сам
+раскрывается сбоку от пункта, на узком экране под ним: `placement` задавать не
+нужно. «Прицел» (защита подменю от случайного закрытия при движении курсора к
+нему) даёт react-aria, свой не пишите.
 
 ## Когда использовать
 
@@ -50,9 +53,9 @@ story: src/components/overlays/Menu.stories.tsx
 button look props, `icon`, `children`, `disabled`, `aria-label` и `className`;
 `aria-label` обязателен, если у кнопки нет подписи; с `iconOnly` её нет всегда.
 `Menu` принимает обычные `AriaMenuProps`, плюс `offset` — отступ панели от кнопки
-в пикселях (умолчание 6) и `placement` — сторона раскрытия (умолчание
-`bottom start`; ещё `bottom end`, `top start`, `top end`, `right top`,
-`left top`).
+в пикселях (умолчание 6) и `placement` — сторона раскрытия (умолчание корневого
+меню `bottom start`; ещё `bottom end`, `top start`, `top end`, `right top`,
+`left top`; умолчание подменю — ниже).
 
 `MenuItem` принимает props `AriaMenuItem`, `icon`, `shortcut`, `tone`, `disabled`
 и `className`; действие передавайте в `onAction`. `MenuSection` принимает
@@ -60,6 +63,19 @@ button look props, `icon`, `children`, `disabled`, `aria-label` и `className`;
 `selectionMode`, `selectedKeys` и `onSelectionChange` на section, а не `checked`
 на item. `MenuSeparator` разделяет группы.
 
+Подменю — `Menu` внутри `SubmenuTrigger` — по умолчанию раскрывается справа от
+своего пункта, верхним краем вровень с ним. Если справа не хватает места,
+react-aria переворачивает подменю влево. При письме справа налево всё зеркально:
+подменю раскрывается слева от пункта. На узком экране (до 639px шириной) места
+сбоку нет ни справа, ни слева, и подменю встаёт под своим пунктом, поверх
+родительского меню. Явный `placement` у вложенного `Menu` побеждает умолчание, в
+том числе на телефоне. Корневое меню раскрывается как прежде — `bottom start`.
+То же правило у подменю Редактора.
+
+Движение курсора к подменю по диагонали его не закрывает и не переключает на
+соседний пункт: этот «Прицел» работает в `SubmenuTrigger` из react-aria. Кит его
+не подменяет и своего не добавляет — не пишите поверх него свой.
+
 Высоту панели меню задаёт react-aria по видимой области. Пункты, которые в неё
 не влезли, прокручиваются внутри панели (`overflow-y: auto`, прокрутка не
 уходит на страницу), а не рисуются за её краем поверх содержимого. На iOS

package/docs/getting-started.en.md

@@ -1,5 +1,5 @@
 ---
-sourceHash: 6f3e6f49e2eb
+sourceHash: 5f89459633fb
 ---
 
 # Setting up `@olddevs/ui`
@@ -132,9 +132,9 @@ peer dependencies are treated as external, and the metric is gzip:
 | `cn` and `tableStateToParams`                                                                            | 0.6 kB   |
 | one `Button`                                                                                             | 1.6 kB   |
 | `DataTable`                                                                                              | 9.0 kB   |
-| the whole kit (`import *`)                                                                               | 71.4 kB  |
-| `RichTextEditor` from `@olddevs/ui/editor`, without the engine, "start"                                  | 70.4 kB  |
-| `RichTextEditor` with the Tiptap engine, "start" (static graph, `basic`)                                 | 295.1 kB |
+| the whole kit (`import *`)                                                                               | 76.4 kB  |
+| `RichTextEditor` from `@olddevs/ui/editor`, without the engine, "start"                                  | 70.6 kB  |
+| `RichTextEditor` with the Tiptap engine, "start" (static graph, `basic`)                                 | 295.3 kB |
 | `RichTextEditor` with the Tiptap engine, "full" (with all lazy chunks, `full`)                           | 339.1 kB |
 | `RichTextView` from `@olddevs/ui/editor`, Tiptap engine included in the measurement                      | 12.0 kB  |
 | `sanitizeRichText` and `richTextSanitizeConfig` from `@olddevs/ui/editor/schema`, Tiptap engine included | 3.6 kB   |

package/docs/getting-started.md

@@ -129,9 +129,9 @@ peer-зависимости внешние, метрика gzip:
 | `cn` и `tableStateToParams`                                                                                 | 0,6 кБ   |
 | одна `Button`                                                                                               | 1,6 кБ   |
 | `DataTable`                                                                                                 | 9,0 кБ   |
-| весь кит целиком (`import *`)                                                                               | 71,4 кБ  |
-| `RichTextEditor` из `@olddevs/ui/editor`, без движка, «старт»                                               | 70,4 кБ  |
-| `RichTextEditor` вместе с движком Tiptap, «старт» (статический граф, `basic`)                               | 295,1 кБ |
+| весь кит целиком (`import *`)                                                                               | 76,4 кБ  |
+| `RichTextEditor` из `@olddevs/ui/editor`, без движка, «старт»                                               | 70,6 кБ  |
+| `RichTextEditor` вместе с движком Tiptap, «старт» (статический граф, `basic`)                               | 295,3 кБ |
 | `RichTextEditor` вместе с движком Tiptap, «полный» (со всеми ленивыми чанками, `full`)                      | 339,1 кБ |
 | `RichTextView` из `@olddevs/ui/editor`, движок Tiptap в замер включён                                       | 12,0 кБ  |
 | `sanitizeRichText` и `richTextSanitizeConfig` из `@olddevs/ui/editor/schema`, движок Tiptap в замер включён | 3,6 кБ   |

package/docs/glossary.en.md

@@ -1,5 +1,5 @@
 ---
-sourceHash: 7b328de94ead
+sourceHash: 2524e6589eaa
 ---
 
 # Glossary of `@olddevs/ui`
@@ -124,6 +124,11 @@ search for a single word.
 | **tag**               | `Tag` in `TagGroup` and `TagInput`: a compact element with text and an optional remove button                              | The Editor's Mark and a field label                                                                    |
 | **close button**      | The button with an "×" that closes a dialog, drawer, popover or notification; in a search field it is the **clear button** | A "Cancel" button. Do not write: cross                                                                 |
 | **shortcut list**     | `ShortcutsHelp`: a dialog with a list of keyboard shortcuts                                                                | The Editor's Shortcuts reference: that one opens from the Toolbar and describes the Editor's shortcuts |
+| **mega menu**         | `MegaMenu`: a category column and the showcase of the hovered category, an Amazon-style catalog                            | `Menu`: that one is for commands, not navigation. Do not write: mega dropdown                          |
+| **category**          | `MegaMenuCategory`: a row of the category column with a label, an icon and its own showcase                                | A menu item (`MenuItem`)                                                                               |
+| **category column**   | The vertical list of categories in a mega menu                                                                             | `SideNav`: that one expands branches in place                                                          |
+| **showcase**          | The area next to the category column with the open category's content: link columns, promos                                | The Editor toolbar, a popover                                                                          |
+| **aim**               | Deferring the category switch while the pointer cuts diagonally toward the open showcase                                   | An opening delay: aim never slows down a direct hover                                                  |
 
 ## Editor
 

package/docs/glossary.md

@@ -120,6 +120,11 @@
 | **Тег**                    | `Tag` в `TagGroup` и `TagInput`: компактный элемент с текстом и необязательной кнопкой удаления                 | Меткой Редактора (`Mark`) и подписью поля. Не пишем: таг                                                |
 | **Кнопка закрытия**        | Кнопка с иконкой «×», которая закрывает окно, ящик, поповер или уведомление; у поля поиска — **кнопка очистки** | Кнопкой «Отмена». Не пишем: крестик                                                                     |
 | **Свод сочетаний**         | `ShortcutsHelp`: окно со списком сочетаний клавиш                                                               | Справочником Редактора: тот открывается из Панели и описывает сочетания Редактора                       |
+| **Мегаменю**               | `MegaMenu`: Столбец категорий и Витрина наведённой Категории — каталог в духе Amazon                            | `Menu`: тот для команд, а не для навигации. Не пишем: мега-дропдаун                                     |
+| **Категория**              | `MegaMenuCategory`: строка Столбца с подписью, иконкой и своей Витриной                                         | Пунктом меню (`MenuItem`)                                                                               |
+| **Столбец категорий**      | Вертикальный список Категорий Мегаменю                                                                          | `SideNav`: тот раскрывает ветки на месте                                                                |
+| **Витрина**                | Область рядом со Столбцом с содержимым открытой Категории: колонки ссылок, промо                                | Панелью Редактора и поповером                                                                           |
+| **Прицел**                 | Отложенная смена Категории, пока курсор идёт наискосок к открытой Витрине                                       | Задержкой открытия: прямое наведение Прицел не тормозит                                                 |
 
 ## Редактор
 

package/llms.txt

@@ -108,6 +108,7 @@
 - [Breadcrumbs](docs/components/navigation/breadcrumbs.md): `Breadcrumbs` показывает путь до текущей страницы.
 - [Pagination](docs/components/navigation/pagination.md): `Pagination` — controlled pagination для уже разбитой на страницы коллекции.
 - [Stepper](docs/components/navigation/stepper.md): `Stepper` показывает порядок шагов мастера; текущий индекс задаёт родитель (controlled).
+- [MegaMenu](docs/components/navigation/mega-menu.md): `MegaMenu` — каталог магазина в духе Amazon: слева Столбец категорий, справа от наведённой Категории — её Витрина с колонками ссылок и любым своим содержимым.
 - [TreeView](docs/components/navigation/tree-view.md): Иерархия с раскрытием, выбором и клавиатурой на `Tree` из react-aria.
 - [SelectionBar и useStickyOffset](docs/components/navigation/selection-bar.md): `SelectionBar` — полоса массовых действий: «Выбрано 12» и что с этим можно сделать.
 - [ContextualSaveBar](docs/components/navigation/contextual-save-bar.md): Полоса несохранённых изменений: появляется с первой правкой формы, показывает «есть несохранённые изменения» (или их число) и две кнопки — сохранить и отменить.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olddevs/ui",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "description": "Olddevs UI — design system: tokens, themes and accessible UI primitives",
   "license": "MIT",
   "private": false,