@soxa-ui/plugins 0.0.0-stage → 0.3.0-beta.1

package/dist/custom/list/typeahead.js

@@ -0,0 +1,58 @@
+/**
+* Текст элемента, по которому идёт набор, — его `text`. У элемента без
+* текста — пусто, и набор его не находит.
+*/
+var itemText = (item) => "text" in item && typeof item.text === "string" ? item.text : "";
+var TTypeahead = class {
+	_timeout;
+	_query = "";
+	_at = 0;
+	/** @param timeout — пауза, после которой следующая буква начинает новый набор, мс */
+	constructor(_timeout = 500) {
+		this._timeout = _timeout;
+	}
+	/**
+	* Идёт ли набор: с последней буквы прошло не больше паузы. Пока он идёт,
+	* пробел — тоже буква («Сохранить как»), а не нажатие элемента.
+	*/
+	typing(now = Date.now()) {
+		return this._query !== "" && now - this._at <= this._timeout;
+	}
+	/**
+	* Буква набора: продолжить слово или начать новое — и найти элемент.
+	*
+	* @param char — набранная буква
+	* @param items — элементы по порядку, по которым идёт навигация
+	* @param current — подсвеченный элемент; `null` — поиск с первого
+	* @param textOf — текст элемента, по которому идёт сравнение
+	* @returns элемент, на который встать, или `null` — совпадения нет, и
+	*   подсветка остаётся на месте
+	*/
+	next(char, items, current, textOf, now = Date.now()) {
+		this._query = this.typing(now) ? this._query + char : char;
+		this._at = now;
+		return match(items, current, this._query, textOf);
+	}
+	/** Сбросить набор: следующая буква начнёт новый. */
+	reset() {
+		this._query = "";
+		this._at = 0;
+	}
+};
+/**
+* Первый по кругу элемент, чей текст начинается с набранного. Повторённая
+* буква — это одна буква: ищется со следующего за подсвеченным.
+*/
+function match(items, current, query, textOf) {
+	const needle = query.toLowerCase();
+	const search = [...needle].every((char) => char === needle[0]) ? needle[0] : needle;
+	const index = current === null ? -1 : items.indexOf(current);
+	const from = index === -1 ? 0 : index + (search.length === 1 ? 1 : 0);
+	for (let step = 0; step < items.length; step++) {
+		const item = items[(from + step) % items.length];
+		if (textOf(item).trim().toLowerCase().startsWith(search)) return item;
+	}
+	return null;
+}
+//#endregion
+export { TTypeahead, itemText };

package/dist/custom/menu/focus/focus.plugin.d.ts

@@ -0,0 +1,61 @@
+import type { IPluginContext } from '../../../base';
+import { TPopoverFocusPlugin } from '../../popover/focus';
+import type { IOverlayOpenOptions } from '../../overlay/types';
+/**
+ * TMenuFocusPlugin — модель фокуса меню у кнопки (APG Menu Button) и
+ * контекстного меню.
+ *
+ * Немодальная, как у Popover, и от него наследует всё общее: запомнить,
+ * откуда открыли, увести фокус в панель кадром позже, вернуть его при
+ * закрытии, закрыться по Escape, не возвращать фокус после нажатия и фокуса
+ * мимо, а запасной возврат — на триггер в корне. Поэтому Escape и нажатие
+ * пункта возвращают фокус на триггер, а нажатие мимо — нет: пользователь уже
+ * там, куда нажал.
+ *
+ * Своё у меню — три вещи:
+ *
+ * - **куда при открытии.** Фокус в меню идёт за подсветкой
+ *   (`TMenuKeyboardPlugin`): открыли клавишей — подсвечен крайний пункт, и
+ *   фокус встаёт на его строку; открыли кликом — подсветки нет, фокус на самой
+ *   панели (`tabindex="-1"`), и первая стрелка подсветит первый пункт. Первая
+ *   остановка Tab панели не годится: у пунктов её нет вовсе. У контекстного
+ *   меню так же: клавиша контекстного меню — первый пункт, правая кнопка и
+ *   касание — панель;
+ * - **Tab.** Остановок Tab в меню нет, и Tab из него закрывает меню (APG): Tab
+ *   ведёт к первой остановке после корня — будто панель стоит в документе
+ *   сразу за триггером — и фокус не возвращает; остановок после корня нет —
+ *   Tab не гасится, фокус уводит браузер. Shift+Tab закрывает с возвратом:
+ *   предыдущая остановка перед панелью — сам триггер. Tab в подменю и с
+ *   последней остановки панели пункта — так же: о нём сообщает модель фокуса
+ *   слоя (`tab`), и меню закрывается целиком, со всеми подменю и панелями.
+ *   Остановки самого меню и его слоёв — пунктов с панелью, гаснущих вместе с
+ *   ним, — в кандидаты не идут: панель пункта ещё на экране, и её остановки
+ *   стоят в документе после корня;
+ * - **куда вернуть фокус, когда возвращать некуда** — фокус был на `body`.
+ *   Запасной возврат Popover — на кнопку в корне — годится кнопке. У
+ *   контекстного меню в корне область, а она бывает нефокусируемой, и её
+ *   первая остановка Tab — не то место, откуда меню вызвали: фокус не
+ *   возвращается никуда. Запасной возврат выбирает подписка на смену способа
+ *   открытия, а не проверка при закрытии.
+ */
+export declare class TMenuFocusPlugin extends TPopoverFocusPlugin {
+    private _owner;
+    private _keyboard;
+    /** Запасной возврат фокуса — по способу открытия (`openOn`). */
+    private _fallback;
+    install(ctx: IPluginContext, options?: IOverlayOpenOptions): void;
+    destroy(): void;
+    /** Фокус при открытии — строке подсвеченного пункта, без подсветки — панели. */
+    protected _focusCandidates(panel: Element): readonly Element[];
+    /** Запомненного элемента нет — у кнопки на неё, у области никуда. */
+    protected _returnCandidates(root: Element): readonly Element[];
+    protected _onTab(event: KeyboardEvent): void;
+    /**
+     * Tab из меню — из его панели, из подменю или из панели пункта: Shift+Tab
+     * закрывает с возвратом на триггер, Tab — без возврата, к остановке за
+     * корнем.
+     */
+    private _leave;
+    /** Запасной возврат: у области — никуда, у кнопки — остановки корня, как у Popover. */
+    private _syncFallback;
+}

package/dist/custom/menu/focus/focus.plugin.js

@@ -0,0 +1,105 @@
+import { tabStopsAfter } from "../../../utils/tabStopsAfter.js";
+import { focusFirst } from "../../../utils/focusFirst.js";
+import { TMenuKeyboardPlugin } from "../keyboard/keyboard.plugin.js";
+import { TPopoverFocusPlugin } from "../../popover/focus/focus.plugin.js";
+import { listenNestedTabs } from "../submenu-focus/focus.plugin.js";
+//#region src/custom/menu/focus/focus.plugin.ts
+/** Возвращать фокус некуда. */
+var NOWHERE = () => [];
+/**
+* TMenuFocusPlugin — модель фокуса меню у кнопки (APG Menu Button) и
+* контекстного меню.
+*
+* Немодальная, как у Popover, и от него наследует всё общее: запомнить,
+* откуда открыли, увести фокус в панель кадром позже, вернуть его при
+* закрытии, закрыться по Escape, не возвращать фокус после нажатия и фокуса
+* мимо, а запасной возврат — на триггер в корне. Поэтому Escape и нажатие
+* пункта возвращают фокус на триггер, а нажатие мимо — нет: пользователь уже
+* там, куда нажал.
+*
+* Своё у меню — три вещи:
+*
+* - **куда при открытии.** Фокус в меню идёт за подсветкой
+*   (`TMenuKeyboardPlugin`): открыли клавишей — подсвечен крайний пункт, и
+*   фокус встаёт на его строку; открыли кликом — подсветки нет, фокус на самой
+*   панели (`tabindex="-1"`), и первая стрелка подсветит первый пункт. Первая
+*   остановка Tab панели не годится: у пунктов её нет вовсе. У контекстного
+*   меню так же: клавиша контекстного меню — первый пункт, правая кнопка и
+*   касание — панель;
+* - **Tab.** Остановок Tab в меню нет, и Tab из него закрывает меню (APG): Tab
+*   ведёт к первой остановке после корня — будто панель стоит в документе
+*   сразу за триггером — и фокус не возвращает; остановок после корня нет —
+*   Tab не гасится, фокус уводит браузер. Shift+Tab закрывает с возвратом:
+*   предыдущая остановка перед панелью — сам триггер. Tab в подменю и с
+*   последней остановки панели пункта — так же: о нём сообщает модель фокуса
+*   слоя (`tab`), и меню закрывается целиком, со всеми подменю и панелями.
+*   Остановки самого меню и его слоёв — пунктов с панелью, гаснущих вместе с
+*   ним, — в кандидаты не идут: панель пункта ещё на экране, и её остановки
+*   стоят в документе после корня;
+* - **куда вернуть фокус, когда возвращать некуда** — фокус был на `body`.
+*   Запасной возврат Popover — на кнопку в корне — годится кнопке. У
+*   контекстного меню в корне область, а она бывает нефокусируемой, и её
+*   первая остановка Tab — не то место, откуда меню вызвали: фокус не
+*   возвращается никуда. Запасной возврат выбирает подписка на смену способа
+*   открытия, а не проверка при закрытии.
+*/
+var TMenuFocusPlugin = class extends TPopoverFocusPlugin {
+	_owner = null;
+	_keyboard = null;
+	/** Запасной возврат фокуса — по способу открытия (`openOn`). */
+	_fallback = NOWHERE;
+	install(ctx, options) {
+		super.install(ctx, options);
+		this._owner = ctx.getInstance() ?? null;
+		this._keyboard = ctx.get(TMenuKeyboardPlugin) ?? null;
+		this._syncFallback();
+		this._listenTo(this._owner?.events, "change:openOn", () => this._syncFallback());
+		listenNestedTabs(ctx, (event) => this._leave(event));
+	}
+	destroy() {
+		this._owner = null;
+		this._keyboard = null;
+		super.destroy();
+	}
+	/** Фокус при открытии — строке подсвеченного пункта, без подсветки — панели. */
+	_focusCandidates(panel) {
+		const row = this._keyboard?.highlightedRow;
+		return row ? [row, panel] : [panel];
+	}
+	/** Запомненного элемента нет — у кнопки на неё, у области никуда. */
+	_returnCandidates(root) {
+		return this._fallback(root);
+	}
+	_onTab(event) {
+		const root = this._root;
+		const panel = this._panel;
+		const active = root?.ownerDocument.activeElement;
+		if (!root || !panel || !active || !panel.contains(active)) return;
+		this._leave(event);
+	}
+	/**
+	* Tab из меню — из его панели, из подменю или из панели пункта: Shift+Tab
+	* закрывает с возвратом на триггер, Tab — без возврата, к остановке за
+	* корнем.
+	*/
+	_leave(event) {
+		const root = this._root;
+		const panel = this._panel;
+		if (!root || !panel) return;
+		if (event.shiftKey) {
+			this._close();
+			event.preventDefault();
+			return;
+		}
+		const after = tabStopsAfter(root, panel).filter((stop) => !this._dismiss?.isInside(stop));
+		this._restore = false;
+		this._close();
+		if (focusFirst(after)) event.preventDefault();
+	}
+	/** Запасной возврат: у области — никуда, у кнопки — остановки корня, как у Popover. */
+	_syncFallback() {
+		this._fallback = this._owner?.openOn === "contextmenu" ? NOWHERE : (root) => super._returnCandidates(root);
+	}
+};
+//#endregion
+export { TMenuFocusPlugin };

package/dist/custom/menu/focus/index.d.ts

@@ -0,0 +1,2 @@
+export { TMenuFocusPlugin } from './focus.plugin';
+export type { TMenuFocusPluginEvents } from './types';

package/dist/custom/menu/focus/types.d.ts

@@ -0,0 +1,2 @@
+import type { TPluginEvents } from '../../../base';
+export type TMenuFocusPluginEvents = TPluginEvents;

package/dist/custom/menu/hover/hover.plugin.d.ts

@@ -0,0 +1,99 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TMenuHoverPluginEvents } from './types';
+/**
+ * TMenuHoverPlugin — указатель в панели одного уровня меню: корня или
+ * подменю.
+ *
+ * **Подсветка**, пока меню открыто: мышь и перо над доступным пунктом
+ * подсвечивают его, уход с пункта — на разделитель, подпись группы, поле
+ * панели или за панель — и выключенный пункт подсветку снимают. Подсветка —
+ * фокус (навигация уровня, без прокрутки), а пункт, срезанный краем списка,
+ * докручивает прокрутка списка — тем же правилом, что подсветку от клавиш.
+ * Своего наведения у строки нет: иначе после стрелок горели бы две строки —
+ * подсвеченная и та, что под указателем. Касание не подсвечивает: у пальца
+ * наведения нет, а нажатие пункта — его клик.
+ *
+ * **Панели пунктов** — подменю и панель пункта с панелью
+ * (`Menu.PopoverItem`) — намерение указателя (APG Menu, как Radix и React
+ * Aria):
+ *
+ * - указатель, простоявший на пункте со своей панелью `PANEL_OPEN_DELAY`,
+ *   открывает её — через коллекцию (`openItem`): выключенному она откажет.
+ *   Фокус остаётся на строке: в панель он входит указателем или клавишами.
+ *   Подменю на открытии фокус на строке и так оставляет, а модель фокуса
+ *   пункта с панелью увела бы его в панель, как после нажатия, — ей плагин
+ *   сообщает, что панель открыл указатель (`keepFocusOnRow`). Нажали строку,
+ *   пока указатель ждал, — панель уже открыта нажатием, и фокус у неё;
+ * - указатель ушёл со строки пункта с открытой панелью — от точки ухода к
+ *   панели ложится путь (`graceArea`): пока указатель на нём, пункты по
+ *   дороге подсветку не перехватывают, и панель открыта. Путь держит
+ *   `PANEL_GRACE_DELAY`, а сходит с него указатель — подсветка уходит к
+ *   пункту под ним, и панель закрывается тем же путём, что от клавиш: фокус
+ *   ушёл из пункта — его панель закрылась (`TDismissPlugin` с
+ *   `focusOutside`);
+ * - указатель ушёл с панели меню, пока панель пункта открыта, — подсветка
+ *   остаётся у его строки: указатель уходит в его панель.
+ *
+ * Панель пункта (`TDismissPlugin` по пометке владельцем) и его модель фокуса
+ * плагин берёт у набора пункта, а набор — в реестре коллекции.
+ *
+ * Слушатели висят на панели, пока меню открыто: панель телепортирована, и
+ * находит её `TDismissPlugin` по пометке владельцем.
+ */
+export declare class TMenuHoverPlugin extends TBasePlugin<any, TMenuHoverPluginEvents> {
+    private _owner;
+    private _dismiss;
+    private _navigation;
+    private _elements;
+    private _bundles;
+    /** Корень объявлен — панель есть где искать. */
+    private _root;
+    /** Узел нужен только под слушатели — отсюда и тип. */
+    private _panel;
+    /** Пункт, над которым указатель был прошлым ходом. */
+    private _lastUid;
+    private _grace;
+    private _pendingOpen;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /** Слушать панель, пока меню открыто и корень объявлен. */
+    private _syncPanel;
+    private _unlistenPanel;
+    /** Пункт под указателем: показанный, чей узел содержит цель события. */
+    private _uidAt;
+    private _shown;
+    /** Пункт этого уровня с открытой панелью — подменю или своей; `null` — такого нет. */
+    private _opened;
+    private readonly _onPointerMove;
+    /**
+     * Указатель ушёл с панели: пункт с открытой панелью держит подсветку своей
+     * строки. Путь к ней снят — указатель до панели дошёл или ушёл мимо, и
+     * вернувшийся указатель решает заново.
+     */
+    private readonly _onPointerLeave;
+    /**
+     * Идёт ли указатель к открытой панели пункта. Только что ушёл с его строки
+     * — путь ложится от точки ухода; путь есть и указатель на нём — да; сошёл
+     * с пути — путь снят.
+     */
+    private _onGrace;
+    /** Путь от точки ухода к панели пункта — на время `PANEL_GRACE_DELAY`. */
+    private _layGrace;
+    private _dropGrace;
+    /**
+     * Пункт со своей панелью под указателем — подменю или пункт с панелью —
+     * откроется, если указатель на нём простоит: доступный, закрытый, —
+     * открытый, выключенный и пункт без своей панели ожидание снимают.
+     */
+    private _scheduleOpen;
+    /**
+     * Открыть панель пункта указателем: фокус остаётся на строке. Панель уже
+     * открыта — строку нажали, пока указатель ждал, — фокус ведёт нажатие, и
+     * трогать его нечего. Модель фокуса пункта с панелью увела бы фокус в
+     * панель, как после нажатия, — ей сказано оставить его на строке; у
+     * подменю её нет, и фокус на строке оно оставляет само.
+     */
+    private _openByPointer;
+    private _cancelOpen;
+}

package/dist/custom/menu/hover/hover.plugin.js

@@ -0,0 +1,235 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TCollectionBundlesPlugin } from "../../collection/bundles.plugin.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { TCollectionElements } from "../../collection/collection-elements.plugin.js";
+import { graceArea, isPointInPolygon } from "../../../utils/graceArea.js";
+import { TDismissPlugin } from "../../dismiss/dismiss.plugin.js";
+import { TMenuKeyboardPlugin } from "../keyboard/keyboard.plugin.js";
+import { TMenuSubmenuKeyboardPlugin } from "../submenu-keyboard/keyboard.plugin.js";
+import { TMenuPopoverItemFocusPlugin } from "../popover-item-focus/focus.plugin.js";
+import { batchOf, isMenuPopupItem, menuOf } from "@soxa-ui/core";
+//#region src/custom/menu/hover/hover.plugin.ts
+/**
+* Сколько указатель стоит на пункте со своей панелью, пока она не откроется,
+* мс: указатель, который проходит мимо, панель не раскрывает (Radix — те же
+* 100 мс у подменю).
+*/
+var PANEL_OPEN_DELAY = 100;
+/**
+* Сколько держит путь к открытой панели пункта после ухода со строки, мс:
+* дольше указатель идёт к панели только стоя, а стоящий на соседнем пункте
+* его и выбрал (Radix — те же 300 мс).
+*/
+var PANEL_GRACE_DELAY = 300;
+/** Указатель, который наводят, — мышь и перо. У пальца наведения нет. */
+var hovers = (e) => e.pointerType === "mouse" || e.pointerType === "pen";
+/**
+* TMenuHoverPlugin — указатель в панели одного уровня меню: корня или
+* подменю.
+*
+* **Подсветка**, пока меню открыто: мышь и перо над доступным пунктом
+* подсвечивают его, уход с пункта — на разделитель, подпись группы, поле
+* панели или за панель — и выключенный пункт подсветку снимают. Подсветка —
+* фокус (навигация уровня, без прокрутки), а пункт, срезанный краем списка,
+* докручивает прокрутка списка — тем же правилом, что подсветку от клавиш.
+* Своего наведения у строки нет: иначе после стрелок горели бы две строки —
+* подсвеченная и та, что под указателем. Касание не подсвечивает: у пальца
+* наведения нет, а нажатие пункта — его клик.
+*
+* **Панели пунктов** — подменю и панель пункта с панелью
+* (`Menu.PopoverItem`) — намерение указателя (APG Menu, как Radix и React
+* Aria):
+*
+* - указатель, простоявший на пункте со своей панелью `PANEL_OPEN_DELAY`,
+*   открывает её — через коллекцию (`openItem`): выключенному она откажет.
+*   Фокус остаётся на строке: в панель он входит указателем или клавишами.
+*   Подменю на открытии фокус на строке и так оставляет, а модель фокуса
+*   пункта с панелью увела бы его в панель, как после нажатия, — ей плагин
+*   сообщает, что панель открыл указатель (`keepFocusOnRow`). Нажали строку,
+*   пока указатель ждал, — панель уже открыта нажатием, и фокус у неё;
+* - указатель ушёл со строки пункта с открытой панелью — от точки ухода к
+*   панели ложится путь (`graceArea`): пока указатель на нём, пункты по
+*   дороге подсветку не перехватывают, и панель открыта. Путь держит
+*   `PANEL_GRACE_DELAY`, а сходит с него указатель — подсветка уходит к
+*   пункту под ним, и панель закрывается тем же путём, что от клавиш: фокус
+*   ушёл из пункта — его панель закрылась (`TDismissPlugin` с
+*   `focusOutside`);
+* - указатель ушёл с панели меню, пока панель пункта открыта, — подсветка
+*   остаётся у его строки: указатель уходит в его панель.
+*
+* Панель пункта (`TDismissPlugin` по пометке владельцем) и его модель фокуса
+* плагин берёт у набора пункта, а набор — в реестре коллекции.
+*
+* Слушатели висят на панели, пока меню открыто: панель телепортирована, и
+* находит её `TDismissPlugin` по пометке владельцем.
+*/
+var TMenuHoverPlugin = class extends TBasePlugin {
+	_owner = null;
+	_dismiss = null;
+	_navigation = null;
+	_elements = null;
+	_bundles = null;
+	/** Корень объявлен — панель есть где искать. */
+	_root = null;
+	/** Узел нужен только под слушатели — отсюда и тип. */
+	_panel = null;
+	/** Пункт, над которым указатель был прошлым ходом. */
+	_lastUid = void 0;
+	_grace = null;
+	_pendingOpen = null;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance() ?? null;
+		this._dismiss = ctx.get(TDismissPlugin) ?? null;
+		this._navigation = ctx.get(TMenuKeyboardPlugin) ?? ctx.get(TMenuSubmenuKeyboardPlugin) ?? null;
+		this._elements = ctx.get(TCollectionElements) ?? null;
+		this._bundles = ctx.get(TCollectionBundlesPlugin) ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => {
+			this._root = element;
+			this._syncPanel();
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._root = null;
+			this._syncPanel();
+		});
+		this._listenTo(this._owner?.events, "change:open", () => this._syncPanel());
+	}
+	destroy() {
+		this._unlistenPanel();
+		this._root = null;
+		this._owner = null;
+		this._dismiss = null;
+		this._navigation = null;
+		this._elements = null;
+		this._bundles = null;
+		super.destroy();
+	}
+	/** Слушать панель, пока меню открыто и корень объявлен. */
+	_syncPanel() {
+		const panel = this._root && this._owner?.open ? this._dismiss?.findPanel() ?? null : null;
+		if (panel === this._panel) return;
+		this._unlistenPanel();
+		if (!panel) return;
+		this._panel = panel;
+		panel.addEventListener("pointermove", this._onPointerMove);
+		panel.addEventListener("pointerleave", this._onPointerLeave);
+	}
+	_unlistenPanel() {
+		this._panel?.removeEventListener("pointermove", this._onPointerMove);
+		this._panel?.removeEventListener("pointerleave", this._onPointerLeave);
+		this._panel = null;
+		this._lastUid = void 0;
+		this._dropGrace();
+		this._cancelOpen();
+	}
+	/** Пункт под указателем: показанный, чей узел содержит цель события. */
+	_uidAt(target) {
+		if (!(target instanceof Node)) return void 0;
+		return this._shown().find((item) => this._elements?.getElementByUid(item.uid)?.contains(target))?.uid;
+	}
+	_shown() {
+		return batchOf(this._elements?.engine)?.shown ?? [];
+	}
+	/** Пункт этого уровня с открытой панелью — подменю или своей; `null` — такого нет. */
+	_opened() {
+		return menuOf(this._elements?.engine)?.opened ?? null;
+	}
+	_onPointerMove = (e) => {
+		if (!hovers(e)) return;
+		const point = {
+			x: e.clientX,
+			y: e.clientY
+		};
+		const uid = this._uidAt(e.target);
+		const last = this._lastUid;
+		this._lastUid = uid;
+		if (this._onGrace(point, uid, last)) return;
+		this._scheduleOpen(uid);
+		if (uid !== void 0 && this._navigation?.highlightItem(uid)) return;
+		this._navigation?.unhighlight();
+	};
+	/**
+	* Указатель ушёл с панели: пункт с открытой панелью держит подсветку своей
+	* строки. Путь к ней снят — указатель до панели дошёл или ушёл мимо, и
+	* вернувшийся указатель решает заново.
+	*/
+	_onPointerLeave = (e) => {
+		if (!hovers(e)) return;
+		this._lastUid = void 0;
+		this._dropGrace();
+		this._cancelOpen();
+		if (this._opened()) return;
+		this._navigation?.unhighlight();
+	};
+	/**
+	* Идёт ли указатель к открытой панели пункта. Только что ушёл с его строки
+	* — путь ложится от точки ухода; путь есть и указатель на нём — да; сошёл
+	* с пути — путь снят.
+	*/
+	_onGrace(point, uid, last) {
+		const opened = this._opened();
+		if (!opened || uid === opened.uid) {
+			this._dropGrace();
+			return false;
+		}
+		if (last === opened.uid) this._layGrace(point, opened);
+		if (this._grace && isPointInPolygon(point, this._grace.area)) return true;
+		this._dropGrace();
+		return false;
+	}
+	/** Путь от точки ухода к панели пункта — на время `PANEL_GRACE_DELAY`. */
+	_layGrace(exit, item) {
+		this._dropGrace();
+		const box = (this._bundles?.getByUid(item.uid)?.get(TDismissPlugin)?.findPanel())?.getBoundingClientRect();
+		if (!box || box.width === 0 || box.height === 0) return;
+		this._grace = {
+			area: graceArea(exit, box),
+			timer: setTimeout(() => {
+				this._grace = null;
+			}, PANEL_GRACE_DELAY)
+		};
+	}
+	_dropGrace() {
+		if (this._grace) clearTimeout(this._grace.timer);
+		this._grace = null;
+	}
+	/**
+	* Пункт со своей панелью под указателем — подменю или пункт с панелью —
+	* откроется, если указатель на нём простоит: доступный, закрытый, —
+	* открытый, выключенный и пункт без своей панели ожидание снимают.
+	*/
+	_scheduleOpen(uid) {
+		const item = uid === void 0 ? void 0 : this._shown().find((shown) => shown.uid === uid);
+		if (!isMenuPopupItem(item) || item.open || item.disabled) {
+			this._cancelOpen();
+			return;
+		}
+		if (this._pendingOpen?.uid === item.uid) return;
+		this._cancelOpen();
+		this._pendingOpen = {
+			uid: item.uid,
+			timer: setTimeout(() => {
+				this._pendingOpen = null;
+				this._openByPointer(item);
+			}, PANEL_OPEN_DELAY)
+		};
+	}
+	/**
+	* Открыть панель пункта указателем: фокус остаётся на строке. Панель уже
+	* открыта — строку нажали, пока указатель ждал, — фокус ведёт нажатие, и
+	* трогать его нечего. Модель фокуса пункта с панелью увела бы фокус в
+	* панель, как после нажатия, — ей сказано оставить его на строке; у
+	* подменю её нет, и фокус на строке оно оставляет само.
+	*/
+	_openByPointer(item) {
+		if (item.open || !menuOf(this._elements?.engine)?.openItem(item)) return;
+		this._bundles?.getByUid(item.uid)?.get(TMenuPopoverItemFocusPlugin)?.keepFocusOnRow();
+	}
+	_cancelOpen() {
+		if (this._pendingOpen) clearTimeout(this._pendingOpen.timer);
+		this._pendingOpen = null;
+	}
+};
+//#endregion
+export { TMenuHoverPlugin };

package/dist/custom/menu/hover/index.d.ts

@@ -0,0 +1,2 @@
+export { TMenuHoverPlugin } from './hover.plugin';
+export type { TMenuHoverPluginEvents } from './types';

package/dist/custom/menu/hover/types.d.ts

@@ -0,0 +1,2 @@
+import type { TPluginEvents } from '../../../base';
+export type TMenuHoverPluginEvents = TPluginEvents;

package/dist/custom/menu/ids/ids.plugin.d.ts

@@ -0,0 +1,29 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TMenuIdsPlugin — связка «кнопка ↔ меню» в документе (APG Menu Button).
+ *
+ * Обе стороны ссылаются друг на друга: у триггера — `id` и `aria-controls`
+ * на панель (`triggerAria`), у панели — `id` и `aria-labelledby` на триггер
+ * (`aria` меню, его разметка раскладывает на панель). Имя меню — текст
+ * кнопки: скринридер объявляет «Действия, меню». Пишутся обе стороны здесь,
+ * от двух `id` одного монтирования: формула одна на обе.
+ *
+ * Связка — у кнопки (`openOn: 'press'`). Контекстное меню вызывают над
+ * областью, а она не кнопка: у неё ни `id` триггера, ни ссылки на панель, а
+ * у панели — ссылки на имя, которого нет. Остаётся `id` панели — он её
+ * собственный. Режим меняется на лету — связка ставится и снимается вместе
+ * с ним, как подпись группы у `TItemGroupIdsPlugin`.
+ *
+ * `id` — от монтирования (`createId`), а не от экземпляра: он нужен только
+ * документу, и на сервере и в браузере обязан совпасть. Пишется при
+ * установке, синхронно, — связка есть уже в первой (и серверной) отрисовке.
+ * Ссылки стоят и у закрытого меню: панель всегда в документе, закрытие её
+ * только прячет.
+ *
+ * Шина меню бывает долговечнее плагина — приложение передаёт свой `ctrl`, —
+ * поэтому подписка через `_listenTo`.
+ */
+export declare class TMenuIdsPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

package/dist/custom/menu/ids/ids.plugin.js

@@ -0,0 +1,46 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+//#region src/custom/menu/ids/ids.plugin.ts
+/**
+* TMenuIdsPlugin — связка «кнопка ↔ меню» в документе (APG Menu Button).
+*
+* Обе стороны ссылаются друг на друга: у триггера — `id` и `aria-controls`
+* на панель (`triggerAria`), у панели — `id` и `aria-labelledby` на триггер
+* (`aria` меню, его разметка раскладывает на панель). Имя меню — текст
+* кнопки: скринридер объявляет «Действия, меню». Пишутся обе стороны здесь,
+* от двух `id` одного монтирования: формула одна на обе.
+*
+* Связка — у кнопки (`openOn: 'press'`). Контекстное меню вызывают над
+* областью, а она не кнопка: у неё ни `id` триггера, ни ссылки на панель, а
+* у панели — ссылки на имя, которого нет. Остаётся `id` панели — он её
+* собственный. Режим меняется на лету — связка ставится и снимается вместе
+* с ним, как подпись группы у `TItemGroupIdsPlugin`.
+*
+* `id` — от монтирования (`createId`), а не от экземпляра: он нужен только
+* документу, и на сервере и в браузере обязан совпасть. Пишется при
+* установке, синхронно, — связка есть уже в первой (и серверной) отрисовке.
+* Ссылки стоят и у закрытого меню: панель всегда в документе, закрытие её
+* только прячет.
+*
+* Шина меню бывает долговечнее плагина — приложение передаёт свой `ctrl`, —
+* поэтому подписка через `_listenTo`.
+*/
+var TMenuIdsPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const menu = ctx.getInstance();
+		if (!menu) return;
+		const triggerId = ctx.createId("trigger");
+		const panelId = ctx.createId("panel");
+		menu.aria.add("id", panelId);
+		const link = () => {
+			const button = menu.openOn === "press";
+			menu.triggerAria.add("id", button ? triggerId : null);
+			menu.triggerAria.add("aria-controls", button ? panelId : null);
+			menu.aria.add("aria-labelledby", button ? triggerId : null);
+		};
+		link();
+		this._listenTo(menu.events, "change:openOn", link);
+	}
+};
+//#endregion
+export { TMenuIdsPlugin };