@olddevs/ui 4.2.1 → 4.3.0

package/src/components/navigation/useMenuAim.ts

@@ -5,14 +5,14 @@ import { useCallback, useEffect, useRef, type RefObject } from "react";
 /*
   ПРИЦЕЛ МЕГАМЕНЮ — приём Amazon, разобранный Беном Каменсом в 2013 году.
 
-  Курсор идёт от Категории к её Витрине наискосок и по пути задевает соседние
-  Категории. Наивное «наведение открывает» сменило бы Витрину у человека под
+  Курсор идёт от Категории к её Полке наискосок и по пути задевает соседние
+  Категории. Наивное «наведение открывает» сменило бы Полку у человека под
   рукой. Прицел смотрит, КУДА движется курсор: пока он идёт в сторону открытой
-  Витрины, соседняя Категория наведение не перехватывает.
+  Полки, соседняя Категория наведение не перехватывает.
 
   Модель — как у `useSafelyMouseToSubmenu` в react-aria, чтобы подменю `Menu` и
   мегаменю вели себя одинаково: направление последнего шага сравнивается с
-  сектором от предыдущей точки к двум углам ближнего края Витрины; смена
+  сектором от предыдущей точки к двум углам ближнего края Полки; смена
   направления прощается; обработка прорежена до кадра; только мышь.
 
   Два осознанных расхождения с react-aria:
@@ -32,7 +32,7 @@ export const AIM_SETTLE_MS = 300;
 const THROTTLE_MS = 16;
 
 /**
- * Сколько шагов «не туда» подряд прощается. Счётчик растёт на шаг к Витрине и
+ * Сколько шагов «не туда» подряд прощается. Счётчик растёт на шаг к Полке и
  * падает на шаг мимо; целится курсор, пока счётчик выше нуля. Отсюда: одно
  * случайное движение вбок прицел не сбрасывает, два подряд — сбрасывают.
  */
@@ -40,7 +40,7 @@ const ALLOWED_INVALID_MOVES = 2;
 
 /**
  * Запас сектора по вертикали, пиксели. Без него курсор, идущий точно в угол
- * Витрины, выпадал бы из сектора на дрожании руки.
+ * Полки, выпадал бы из сектора на дрожании руки.
  */
 const SECTOR_PADDING = 24;
 
@@ -50,7 +50,7 @@ interface Point {
 }
 
 /**
- * Идёт ли шаг `from → to` к Витрине: направление шага лежит внутри сектора от
+ * Идёт ли шаг `from → to` к Полке: направление шага лежит внутри сектора от
  * `from` к двум углам её ближнего края.
  *
  * Векторное произведение, а не `atan2`: тот же сектор без разрыва угла на ±π.
@@ -61,9 +61,9 @@ export function isMovingToward(from: Point, to: Point, rect: DOMRect, side: "lef
   const dy = to.y - from.y;
   if (dx === 0 && dy === 0) return false;
   const edge = side === "right" ? rect.left : rect.right;
-  // Курсор уже за ближним краем — он в Витрине, а не на пути к ней.
+  // Курсор уже за ближним краем — он в Полке, а не на пути к ней.
   if (side === "right" ? from.x >= edge : from.x <= edge) return false;
-  // Шаг от Витрины по горизонтали не может к ней вести.
+  // Шаг от Полки по горизонтали не может к ней вести.
   if (side === "right" ? dx <= 0 : dx >= 0) return false;
   const top = { x: edge - from.x, y: rect.top - SECTOR_PADDING - from.y };
   const bottom = { x: edge - from.x, y: rect.bottom + SECTOR_PADDING - from.y };
@@ -79,25 +79,25 @@ export function isMovingToward(from: Point, to: Point, rect: DOMRect, side: "lef
 const NONE = Symbol("none");
 
 interface MenuAimOptions {
-  /** Открытая Категория; `null` — Витрины нет, и целиться не во что. */
+  /** Открытая Категория; `null` — Полки нет, и целиться не во что. */
   value: string | null;
-  /** Открытая сейчас Витрина: её прямоугольник — цель. */
+  /** Открытая сейчас Полка: её прямоугольник — цель. */
   showcaseRef: RefObject<HTMLElement | null>;
-  /** Сменить Категорию (или закрыть Витрину — `null`). */
+  /** Сменить Категорию (или закрыть Полку — `null`). */
   commit: (next: string | null) => void;
 }
 
 /**
  * Прицел: решает, сменить Категорию под курсором сейчас или отложить.
  *
- * `request` зовётся из наведения на строку Столбца. Если Витрины нет или
+ * `request` зовётся из наведения на строку Столбца. Если Полки нет или
  * курсор не целится — смена сразу. Если целится — смена откладывается: курсор
  * перестал целиться или стоит `AIM_SETTLE_MS` — открывается то, что под ним
- * сейчас; дошёл до Витрины — смена отменяется.
+ * сейчас; дошёл до Полки — смена отменяется.
  *
- * Прямоугольник Витрины берётся заново на каждом шаге, а не кешируется:
+ * Прямоугольник Полки берётся заново на каждом шаге, а не кешируется:
  * прокрутка страницы и смена размера окна не оставляют его устаревшим, а цена
- * — одно чтение раскладки на кадр, и только пока Витрина открыта.
+ * — одно чтение раскладки на кадр, и только пока Полка открыта.
  */
 export function useMenuAim({ value, showcaseRef, commit }: MenuAimOptions) {
   const previous = useRef<Point | null>(null);
@@ -125,7 +125,7 @@ export function useMenuAim({ value, showcaseRef, commit }: MenuAimOptions) {
     timer.current = setTimeout(flush, AIM_SETTLE_MS);
   }, [flush]);
 
-  // Новая Витрина — новая цель: прежний счёт к ней отношения не имеет.
+  // Новая Полка — новая цель: прежний счёт к ней отношения не имеет.
   useEffect(() => {
     aim.current = 0;
     previous.current = null;
@@ -148,7 +148,7 @@ export function useMenuAim({ value, showcaseRef, commit }: MenuAimOptions) {
       previous.current = point;
       if (!showcase || !from) return;
 
-      // Курсор дошёл до Витрины — отложенная смена больше не нужна.
+      // Курсор дошёл до Полки — отложенная смена больше не нужна.
       if (event.target instanceof Node && showcase.contains(event.target)) {
         pending.current = NONE;
         clearTimer();
@@ -171,7 +171,7 @@ export function useMenuAim({ value, showcaseRef, commit }: MenuAimOptions) {
     return () => document.removeEventListener("pointermove", onPointerMove);
   }, [value, showcaseRef, flush, settleLater]);
 
-  /** Курсор наведён на строку Столбца: открыть её (`null` — закрыть Витрину). */
+  /** Курсор наведён на строку Столбца: открыть её (`null` — закрыть Полку). */
   const request = useCallback(
     (next: string | null) => {
       if (next === value) {

package/src/components/overlays/Menu.tsx

@@ -89,9 +89,19 @@ export interface MenuProps<T extends object = object> extends AriaMenuProps<T> {
    * Сторона, с которой панель раскрывается. Корневое меню по умолчанию — под
    * кнопкой слева (`bottom start`); вложенное, внутри `SubmenuTrigger`, —
    * сбоку от своего пункта, а на узком экране под ним. Явное значение
-   * побеждает оба умолчания.
+   * побеждает оба умолчания. `end top` и `start top` — сбоку по концу или
+   * началу строки: при письме справа налево они меняются местами, а
+   * `right top` и `left top` — нет.
    */
-  placement?: "bottom start" | "bottom end" | "top start" | "top end" | "right top" | "left top";
+  placement?:
+    | "bottom start"
+    | "bottom end"
+    | "top start"
+    | "top end"
+    | "end top"
+    | "start top"
+    | "right top"
+    | "left top";
 }
 
 export interface MenuItemProps extends Omit<AriaMenuItemProps, "children" | "className"> {