@olddevs/ui 4.5.1 → 4.6.1

package/docs/components/navigation/mega-menu.en.md

@@ -95,7 +95,7 @@ marked `@deprecated`: the kit calls the current navigation item `active`.
 
 Hovering a category with the mouse opens its flyout at once, with no delay. Exactly one category is highlighted,
 the one whose flyout is open: the highlight follows `aria-expanded`, not `:hover`. Hovering a category without a
-flyout closes the open one, with the same caveat about aim as below.
+flyout closes the open one, with the same caveat about menu aim as below.
 
 The flyout closes 150 ms after the pointer has left both the category column and the flyout, so a brief
 excursion past the edge does not reset the catalog. It also closes on a pointer press outside the catalog and when
@@ -115,12 +115,12 @@ points to where the flyout will appear.
 
 ## Touch and narrow screens
 
-Touch has no hover, so the touch itself (`click`) opens a category, without aim. A pointer whose `pointerType` is
+Touch has no hover, so the touch itself (`click`) opens a category, without menu aim. A pointer whose `pointerType` is
 "touch" or "pen" neither opens a category on hover nor closes the flyout when it leaves: a pen behaves like a
 finger. Touching an open category again neither closes it nor goes anywhere. The flyout closes on a touch outside
 the catalog or on Escape.
 
-The mouse behaves as before: hover, aim and closing after 150 ms all remain while the screen is wide.
+The mouse behaves as before: hover, menu aim and closing after 150 ms all remain while the screen is wide.
 
 On a narrow screen, under 640px (the same breakpoint as `Menu` submenus and Editor submenus), there is no room beside
 the category column for the flyout: the edge of the window would cut it off on the right. So the catalog works as a
@@ -135,7 +135,7 @@ drill-down:
 - When you drill down, focus moves to "Back": the category button is hidden along with the category column, and focus
   left on it would be lost. In the flyout on a narrow screen, the arrow key toward the category column does
   nothing, because the column is not beside it.
-- There is no aim on a narrow screen: hovering with the mouse does not open a category, and moving the mouse away does
+- There is no menu aim on a narrow screen: hovering with the mouse does not open a category, and moving the mouse away does
   not cancel the drill-down. Replacing the column under the cursor would pull it out from under the person's hand.
 - The markup stays on the disclosure pattern: the category button keeps `aria-expanded` and `aria-controls` pointing
   to the region on screen (the button itself is hidden during the drill-down), and the region is named after the
@@ -150,11 +150,11 @@ screen (ADR-0018): the server does not know the width, and the markup it produce
 after hydration, a flyout opened by `defaultValue` is re-rendered once as a drill-down. On a phone the `nav` takes
 the full width through the `max-sm:w-full` class; a `w-*` class from `className` applies on a wide screen.
 
-## Aim
+## Menu aim
 
 On its way from a category to its flyout, the pointer cuts diagonally and brushes against the neighboring
 categories. If hover opened them at once, the flyout would change under the person's hand, and the links would be
-out of reach. Aim watches where the pointer is heading: while it moves toward the open flyout, a neighboring
+out of reach. Menu aim watches where the pointer is heading: while it moves toward the open flyout, a neighboring
 category does not take over the hover.
 
 - The direction of the pointer's last step is compared with the wedge from its previous position to the two corners
@@ -163,8 +163,8 @@ category does not take over the hover.
 - One movement off course is forgiven; two in a row are not, and then the category under the pointer opens.
 - If the pointer stops for 300 ms, the category under it opens even if it was aiming. The menu does not get stuck.
 - When the pointer reaches the flyout, the deferred switch is canceled.
-- Clicking a category opens it at once, bypassing aim. The keyboard knows nothing about aim.
-- Mouse only, and only on a wide screen: touch and pen open a category at once, and a narrow screen has no aim at all.
+- Clicking a category opens it at once, bypassing menu aim. The keyboard knows nothing about menu aim.
+- Mouse only, and only on a wide screen: touch and pen open a category at once, and a narrow screen has no menu aim at all.
 - The first hover, while there is no flyout yet, opens the category with no delay at all: there is nothing to aim at.
 
 The model is the same as for react-aria submenus (`Menu` with `SubmenuTrigger`), so that the two menus of the kit
@@ -303,12 +303,12 @@ into one. `MegaMenuButton` accepts the kit's button look (`variant`, `tone`, `si
 
 ## Related sources and tests
 
-- Implementation: `src/components/navigation/MegaMenu.tsx`; aim is in `src/components/navigation/useMenuAim.ts`.
+- Implementation: `src/components/navigation/MegaMenu.tsx`; menu aim is in `src/components/navigation/useMenuAim.ts`.
 - Tests: `tests/mega-menu.test.tsx` covers roles and `aria-controls`, hover and mounting only the open
   flyout, closing with a delay, roving tabindex, Enter, Escape and the arrows, Tab past the last link,
   a category that is a link, a disabled category, `active` and the `current` alias, `asChild` and `link` (on a
   category and on a column), fragments in a column, the current section and the Tab stop, typeahead, categories
-  inside your own components, the controlled value, a press outside the catalog and server rendering; `tests/mega-menu-aim.test.tsx` covers aim on mocked geometry and fake
+  inside your own components, the controlled value, a press outside the catalog and server rendering; `tests/mega-menu-aim.test.tsx` covers menu aim on mocked geometry and fake
   time, and the flip at the edge; `tests/mega-menu-touch.test.tsx` covers touch and pen, a mocked `matchMedia`,
   the drill-down in place of the category column, "Back" and focus, Escape, labels from the message catalog, the
   drill-down with categories inside your own components and server rendering; the browser test

package/docs/components/overlays/menu.en.md

@@ -17,7 +17,7 @@ use the dedicated `MenuButton`, not a regular `Button`: only it reads react-aria
 `ButtonContext`. The menu suits heterogeneous commands, sections, selected modes
 and submenus; it is not for choosing a field value. A nested `Menu` inside
 `SubmenuTrigger` opens beside its item on its own, and below it on a narrow
-screen: you do not need to set `placement`. The "aim" (protection that keeps a
+screen: you do not need to set `placement`. The "menu aim" (protection that keeps a
 submenu from closing while the pointer travels toward it) comes from react-aria;
 do not write your own.
 
@@ -80,7 +80,7 @@ writing, use `end top` or `start top`. The root menu opens as before, at `bottom
 submenus follow the same rule.
 
 Moving the pointer diagonally toward a submenu neither closes it nor switches to a
-neighboring item: this "aim" is handled by react-aria's `SubmenuTrigger`. The kit
+neighboring item: this "menu aim" is handled by react-aria's `SubmenuTrigger`. The kit
 does not replace it and adds none of its own, so do not write one on top of it.
 
 react-aria sets the menu panel's height from the visible area. Items that do

package/docs/components/overlays/shortcuts-help.en.md

@@ -159,7 +159,7 @@ not know the shortcuts and their names.
   single key gets no separator.
 - In `CommandPalette` an item's shortcut is entirely `aria-hidden` — it is a reminder
   next to an item that can be chosen anyway. Here the shortcut is the dialog's
-  only content, and hiding it would hand a screen reader an empty cheat sheet.
+  only content, and hiding it would hand a screen reader an empty keyboard shortcuts dialog.
 - **Scrolling inside the dialog.** The list sits in a `ScrollArea` no taller than
   70% of the screen height and no taller than 32rem: the header with the close
   button stays in place. The area is a Tab stop with a separate name ("Shortcuts" /

package/docs/components/table/data-table.en.md

@@ -13,14 +13,14 @@ sourceHash: a5e9fc1a0c10
 ## Summary for AI
 
 An application-level table with ready-made behavior on top of the low-level `Table`:
-column visibility and order, density, loading and error states, a table bar slot
+column visibility and order, density, loading and error states, a table toolbar slot
 (`toolbar`). It keeps no state of its own: it accepts `state` and reports changes as a
 patch, usually to `useTableState`.
 
 ## When to use
 
 - A list of entities in an admin panel: filters, column preferences, bulk actions.
-- Anywhere a table needs a table bar and user preferences.
+- Anywhere a table needs a table toolbar and user preferences.
 
 ## When not to use
 
@@ -57,7 +57,7 @@ const { state, set } = useTableState();
 | `selectable`    | `false` | The checkbox column. A separate prop — see below.                    |
 | `loading`       | `false` | Loading is in progress. The behavior depends on whether data exists. |
 | `error`         | —       | **Always** replaces the body, even when there is data.               |
-| `toolbar`       | —       | The table bar — usually `TableToolbar`.                              |
+| `toolbar`       | —       | The table toolbar — usually `TableToolbar`.                          |
 
 The other props go to `Table` — including `renderDetail`, `rowLabel` and
 `onRowAction`.

package/docs/components/table/filter-bar.en.md

@@ -106,7 +106,7 @@ The filter that gets built is an ordinary `TableFilter` with an optional `to`:
 - **A field with an already applied range is not offered again.** Two ranges on
   one field are an intersection, not an addition, and the tokens could not be
   told apart. The token identifier is `<field>:range`.
-- **The consumer computes the result set.** The kit describes the shape of the
+- **The consumer computes the filtered rows.** The kit describes the shape of the
   filter, it does not filter data
   (ADR-0023):
   how to treat the bounds (inclusive, in which time zone) is the application's

package/docs/components/table/toolbar.en.md

@@ -12,7 +12,7 @@ sourceHash: 957697357a68
 
 ## Summary for AI
 
-`TableToolbar` is the table bar: a title, a counter, actions, a filters slot and a
+`TableToolbar` is the table toolbar: a title, a counter, actions, a filters slot and a
 preferences slot. `TablePreferences` is the content behind the gear button: column
 visibility and order, density. Neither stores state: everything comes from above,
 usually from `useTableState`.

package/docs/conventions.en.md

@@ -1,5 +1,5 @@
 ---
-sourceHash: 84104315608a
+sourceHash: 502667bd31f1
 ---
 
 # General conventions for `@olddevs/ui`
@@ -285,7 +285,7 @@ already catches itself. A violation after which the component cannot work is not
   (`vi.stubEnv`), and it stays silent on a correct call.
 
 **An error instead of a warning: `devError(message, cause?)`.** Use it when a violation breaks the whole component
-but not the page: the Tool set of `RichTextEditor` is built incorrectly, the loader of an engine part failed,
+but not the page: the Tool set of `RichTextEditor` is built incorrectly, the loader of the Extensions failed,
 `rangeAt` of the Text card threw an exception. The field shows the author a catalog string on its own, and the
 cause goes to the developer through `console.error`, with the same rules as `devWarn`: in development, once per
 text, in English.

package/docs/conventions.md

@@ -320,7 +320,7 @@ ADR-0034.
 
 **Ошибка вместо предупреждения — `devError(message, cause?)`.** Когда нарушение
 ломает компонент целиком, но не страницу: набор Инструментов `RichTextEditor`
-собран с ошибкой, Загрузчик Части для движка упал, `rangeAt` Карточки бросил
+собран с ошибкой, Загрузчик Extensions упал, `rangeAt` Карточки бросил
 исключение. Поле само показывает автору строку каталога (`editor.toolsFailed`),
 а причина уходит разработчику через `console.error` — с теми же правилами, что у
 `devWarn`: в разработке, один раз на текст, по-английски.

package/docs/getting-started.en.md

@@ -1,5 +1,5 @@
 ---
-sourceHash: 340e1ec512cb
+sourceHash: 45289d832ab0
 ---
 
 # Setting up `@olddevs/ui`
@@ -132,12 +132,12 @@ 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 *`)                                                                               | 77.1 kB  |
-| `RichTextEditor` from `@olddevs/ui/editor`, without the engine, "start"                                  | 72.7 kB  |
-| `RichTextEditor` with the Tiptap engine, "start" (static graph, `basic`)                                 | 297.5 kB |
-| `RichTextEditor` with the Tiptap engine, "full" (with all lazy chunks, `full`)                           | 346.6 kB |
-| `RichTextView` from `@olddevs/ui/editor`, Tiptap engine included in the measurement                      | 12.3 kB  |
-| `sanitizeRichText` and `richTextSanitizeConfig` from `@olddevs/ui/editor/schema`, Tiptap engine included | 3.9 kB   |
+| the whole kit (`import *`)                                                                               | 77.2 kB  |
+| `RichTextEditor` from `@olddevs/ui/editor`, without the engine, "start"                                  | 75.9 kB  |
+| `RichTextEditor` with the Tiptap engine, "start" (static graph, `basic`)                                 | 305.3 kB |
+| `RichTextEditor` with the Tiptap engine, "full" (with all lazy chunks, `full`)                           | 354.6 kB |
+| `RichTextView` from `@olddevs/ui/editor`, Tiptap engine included in the measurement                      | 12.7 kB  |
+| `sanitizeRichText` and `richTextSanitizeConfig` from `@olddevs/ui/editor/schema`, Tiptap engine included | 4.0 kB   |
 | `highlightCodeBlocks` from `@olddevs/ui/editor/highlight`, with lowlight                                 | 22.6 kB  |
 | `highlightCodeNodes` from `@olddevs/ui/editor/highlight`, with lowlight                                  | 22.6 kB  |
 
@@ -146,7 +146,7 @@ The last seven rows are separate Editor entry points with their own budgets
 them are scenarios (ADR-0058, item 11.7):
 **"start"** is the static graph, what ships immediately and what the `basic` Preset costs; **"full"** is the same
 plus all the lazy chunks of the entry point, what `full` ends up loading. The code Block and the table (absent from `basic`,
-and their Engine part weighs more than 10 kB) load lazily; until they arrive, an Editor that includes them shows a Skeleton.
+and their Extensions weigh more than 10 kB) load lazily; until they arrive, an Editor that includes them shows a Skeleton.
 `npm run size` checks that their modules are not in "start". The kit's own code is measured at "start".
 
 In the scenarios the engine is **included in the measurement** on purpose: the consumer installs Tiptap, but
@@ -158,7 +158,7 @@ an app bundler with full minification produced about 133 kB (measured before the
 For `RichTextView`, Tiptap and lowlight are included in the measurement as a check. Its row contains only
 typography and the Island of the "Copy" button on code Blocks (the kit's button and tooltip, the message catalog),
 and the measurement proves that its graph contains neither the engine nor a highlighter. The lightweight
-`@olddevs/ui/editor/schema` entry point is measured the same way (3.9 kB): the Schema, `richTextSchema`, the
+`@olddevs/ui/editor/schema` entry point is measured the same way (4.0 kB): the Schema, `richTextSchema`, the
 `sanitizeRichText` sanitizer with hooks for DOMPurify, including for the rules of custom Tools, and `markRange`.
 
 Server-side highlighting in `@olddevs/ui/editor/highlight` (22.6 kB — almost entirely the highlight.js core and

package/docs/getting-started.md

@@ -129,12 +129,12 @@ peer-зависимости внешние, метрика gzip:
 | `cn` и `tableStateToParams`                                                                                 | 0,6 кБ   |
 | одна `Button`                                                                                               | 1,6 кБ   |
 | `DataTable`                                                                                                 | 9,0 кБ   |
-| весь кит целиком (`import *`)                                                                               | 77,1 кБ  |
-| `RichTextEditor` из `@olddevs/ui/editor`, без движка, «старт»                                               | 72,7 кБ  |
-| `RichTextEditor` вместе с движком Tiptap, «старт» (статический граф, `basic`)                               | 297,5 кБ |
-| `RichTextEditor` вместе с движком Tiptap, «полный» (со всеми ленивыми чанками, `full`)                      | 346,6 кБ |
-| `RichTextView` из `@olddevs/ui/editor`, движок Tiptap в замер включён                                       | 12,3 кБ  |
-| `sanitizeRichText` и `richTextSanitizeConfig` из `@olddevs/ui/editor/schema`, движок Tiptap в замер включён | 3,9 кБ   |
+| весь кит целиком (`import *`)                                                                               | 77,2 кБ  |
+| `RichTextEditor` из `@olddevs/ui/editor`, без движка, «старт»                                               | 75,9 кБ  |
+| `RichTextEditor` вместе с движком Tiptap, «старт» (статический граф, `basic`)                               | 305,3 кБ |
+| `RichTextEditor` вместе с движком Tiptap, «полный» (со всеми ленивыми чанками, `full`)                      | 354,6 кБ |
+| `RichTextView` из `@olddevs/ui/editor`, движок Tiptap в замер включён                                       | 12,7 кБ  |
+| `sanitizeRichText` и `richTextSanitizeConfig` из `@olddevs/ui/editor/schema`, движок Tiptap в замер включён | 4,0 кБ   |
 | `highlightCodeBlocks` из `@olddevs/ui/editor/highlight`, вместе с lowlight                                  | 22,6 кБ  |
 | `highlightCodeNodes` из `@olddevs/ui/editor/highlight`, вместе с lowlight                                   | 22,6 кБ  |
 
@@ -143,7 +143,7 @@ peer-зависимости внешние, метрика gzip:
 них — сценарии (ADR-0058, п. 11.7):
 **«старт»** — статический граф, то, что едет сразу и что платит Пресет `basic`; **«полный»** — он же
 плюс все ленивые чанки входа, то, что в итоге грузит `full`. Блок кода и таблица (их нет в `basic`,
-а их Часть для движка тяжелее 10 кБ) грузятся лениво; до их прихода Редактор, в котором они есть,
+а их Extensions тяжелее 10 кБ) грузятся лениво; до их прихода Редактор, в котором они есть,
 показывает Скелет. `npm run size` проверяет, что их модулей в «старте» нет. Код кита меряется на «старте».
 
 В сценариях движок **внесён в замер** намеренно: Tiptap ставит потребитель, но набор его расширений
@@ -155,7 +155,7 @@ peer-зависимости внешние, метрика gzip:
 У `RichTextView` Tiptap и lowlight внесены в замер ради проверки. В его строку входят только
 типографика и Остров кнопки «Копировать» у Блоков кода (кнопка и подсказка кита, каталог сообщений),
 и замер доказывает, что в графе нет ни движка, ни подсветчика. Так же меряется лёгкий вход
-`@olddevs/ui/editor/schema` (3,9 кБ): Схема, `richTextSchema`, очистка `sanitizeRichText` с хуками для
+`@olddevs/ui/editor/schema` (4,0 кБ): Схема, `richTextSchema`, очистка `sanitizeRichText` с хуками для
 DOMPurify, в том числе по правилам своих Инструментов, и `markRange`.
 
 Серверная подсветка `@olddevs/ui/editor/highlight` (22,6 кБ — почти целиком ядро highlight.js и