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

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

@@ -0,0 +1,95 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { TMenuKeyboardPlugin } from "../keyboard/keyboard.plugin.js";
+import { TMenuPressStrategy } from "./strategies/press.strategy.js";
+import { TMenuContextStrategy } from "./strategies/context.strategy.js";
+//#region src/custom/menu/pointer/pointer.plugin.ts
+/** Стратегия открытия на каждый способ: способ выбирает класс, а не ветку в обработчике. */
+var OPEN_STRATEGIES = {
+	press: TMenuPressStrategy,
+	contextmenu: TMenuContextStrategy
+};
+/**
+* TMenuPointerPlugin — открытие меню указателем.
+*
+* Открытие — стратегия по способу владельца (`openOn`, `strategies/`): у
+* кнопки (`TMenuPressStrategy`) клик по корню переключает меню, у
+* контекстного меню (`TMenuContextStrategy`) `contextmenu` и долгое касание
+* над областью вызывают его у точки вызова (`point` владельца). Стратегию
+* выбирает подписка на `change:openOn`, а не проверка в обработчике, и
+* слушатели корня у каждого способа свои. Вызванное клавишей контекстное
+* меню открывается на первом пункте — через клавиатуру меню, как кнопка с
+* клавиатуры.
+*
+* Указатель в открытой панели — подсветка пунктов и подменю — у
+* `TMenuHoverPlugin`: он общий у меню и подменю, а способ открытия есть
+* только у меню.
+*/
+var TMenuPointerPlugin = class extends TBasePlugin {
+	_owner = null;
+	_keyboard = null;
+	/** Корень — под стратегию открытия. */
+	_root = null;
+	/** Способ открытия на корне — по `openOn` владельца. */
+	_strategy = null;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance() ?? null;
+		this._keyboard = ctx.get(TMenuKeyboardPlugin) ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => {
+			this._root = element;
+			this._syncStrategy();
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._root = null;
+			this._syncStrategy();
+		});
+		this._listenTo(this._owner?.events, "change:openOn", () => this._syncStrategy());
+	}
+	destroy() {
+		this._strategy?.destroy();
+		this._strategy = null;
+		this._root = null;
+		this._owner = null;
+		this._keyboard = null;
+		super.destroy();
+	}
+	/** Открыто ли меню — для стратегий открытия. */
+	get isOpen() {
+		return this._owner?.open ?? false;
+	}
+	/** Переключить меню — нажатие кнопки. */
+	toggle() {
+		const owner = this._owner;
+		if (owner) owner.open = !owner.open;
+	}
+	/**
+	* Вызвать меню у точки окна, открытое — переставить к ней: точку отдаёт
+	* якорю панели разметка. Вызвали клавишей — меню открывается на первом
+	* пункте, как кнопка с клавиатуры, указателем — фокус на панели.
+	*/
+	invoke(point, byKeyboard) {
+		const owner = this._owner;
+		if (!owner) return;
+		owner.point = point;
+		if (byKeyboard && this._keyboard) this._keyboard.openAt("first");
+		else owner.open = true;
+	}
+	/** Закрыть меню. */
+	close() {
+		const owner = this._owner;
+		if (owner) owner.open = false;
+	}
+	/** Стратегия открытия — по способу владельца, на объявленном корне. */
+	_syncStrategy() {
+		this._strategy?.destroy();
+		this._strategy = null;
+		const root = this._root;
+		const owner = this._owner;
+		if (!root || !owner) return;
+		this._strategy = new OPEN_STRATEGIES[owner.openOn](root, this);
+	}
+};
+//#endregion
+export { TMenuPointerPlugin };

package/dist/custom/menu/pointer/strategies/context.strategy.d.ts

@@ -0,0 +1,70 @@
+import type { IMenuOpenHost, IMenuOpenStrategy } from './types';
+/**
+ * TMenuContextStrategy — контекстное меню области (`openOn: 'contextmenu'`):
+ * панель встаёт у точки вызова.
+ *
+ * **Вызов — `contextmenu` на корне.** Его шлёт браузер на правую кнопку мыши,
+ * на долгое касание (Android) и с клавиатуры — на клавишу контекстного меню и
+ * Shift+F10 элементу под фокусом, с точкой у него. `preventDefault` убирает
+ * системное меню, и `contextmenu`, уже погашенное (вложенное контекстное
+ * меню вызвали раньше), не трогается: вызов один. Вызов у открытого меню
+ * переставляет панель к новой точке, а не закрывает и открывает её заново.
+ *
+ * **Чем вызвали**, плагин узнаёт по нажатию в области: перед `contextmenu`
+ * указателя было `pointerdown`, клавиатуры — `keydown`. Вызов клавишей
+ * открывает меню на первом пункте, как кнопку с клавиатуры, указателем —
+ * фокус на панели. Своего признака в событии нет: у вызова с клавиатуры
+ * Chromium отдаёт `pointerType` мыши. Нажатия в области не было вовсе
+ * (меню вызвала ассистивная технология) — вызов клавишей.
+ *
+ * **Долгое касание** — свой таймер только там, где браузер `contextmenu` на
+ * него не шлёт: на сенсорных устройствах Apple (`isAppleTouch`). Палец или
+ * перо, ушедшие дальше порога, — прокрутка, и вызова нет; второй палец —
+ * масштаб, тоже. Браузер, приславший `contextmenu` раньше таймера, таймер
+ * снимает: вызов один. Системное меню долгого касания там — выноска над
+ * ссылкой и картинкой, и `preventDefault` её не убирает: её снимает
+ * `-webkit-touch-callout: none` на корне, пока стратегия стоит, а потом
+ * возвращается прежнее инлайновое значение. Ставит его стратегия, а не тема:
+ * без него не работает поведение, а не вид, — как `touch-action` у
+ * `TSwipePlugin`.
+ *
+ * **Нажатие в области мимо вызова закрывает меню**: область — не кнопка, и
+ * нажатие на неё — то же, что нажатие мимо. Мышь — на `pointerdown`, как у
+ * `TDismissPlugin`, кроме второй кнопки: за ней придёт `contextmenu`, и
+ * панель переедет. Палец и перо — на `pointerup` того же нажатия: с нажатия
+ * начинается и прокрутка, и долгое касание, которое меню переставит.
+ * `TDismissPlugin` эти нажатия мимо не считает: корень — внутри владельца,
+ * — поэтому решает их стратегия, знающая, где вызов.
+ */
+export declare class TMenuContextStrategy implements IMenuOpenStrategy {
+    /** Узел нужен под слушатели и под документ, чьё устройство спрашиваем. */
+    private readonly _root;
+    private readonly _host;
+    /** Долгое касание — своё: браузер `contextmenu` на него не шлёт. */
+    private readonly _longPress;
+    /** Последнее нажатие в области — клавиша, а не указатель. */
+    private _byKeyboard;
+    /** Нажатие пальцем или пером, которое ещё решается. */
+    private _press;
+    /** Инлайновая выноска корня до стратегии; `null` — стратегия её не трогала. */
+    private _callout;
+    constructor(root: Element, host: IMenuOpenHost);
+    destroy(): void;
+    /** Вернуть корню инлайновую выноску, что была до стратегии: пустая — снять свойство. */
+    private _restoreCallout;
+    private readonly _onContextMenu;
+    private readonly _onKeyDown;
+    private readonly _onPointerDown;
+    /** Палец ушёл дальше порога — это прокрутка: ни вызова, ни закрытия. */
+    private readonly _onPointerMove;
+    /** Отпустили, не вызвав меню, — нажатие в области у открытого меню закрывает его. */
+    private readonly _onPointerUp;
+    /** Браузер забрал касание под прокрутку или жест — решать нечего. */
+    private readonly _onPointerCancel;
+    /** Палец продержали — вызов у точки нажатия. */
+    private readonly _onLongPress;
+    /** Нажатие стало вызовом: таймер снят, отпускание меню не закроет. */
+    private _settlePress;
+    /** Нажатия больше нет: таймер снят. */
+    private _dropPress;
+}

package/dist/custom/menu/pointer/strategies/context.strategy.js

@@ -0,0 +1,170 @@
+import { isMeasurableElement } from "../../../../utils/isMeasurableElement.js";
+import { isAppleTouch } from "../../../../utils/isAppleTouch.js";
+//#region src/custom/menu/pointer/strategies/context.strategy.ts
+/** Сколько держать палец, чтобы вызвать контекстное меню, мс, — как у системы. */
+var LONG_PRESS_DELAY = 500;
+/** Насколько палец уходит, пока его держат, px: дальше — уже прокрутка, а не вызов. */
+var LONG_PRESS_SLOP = 10;
+/** Вторая кнопка мыши и кнопка пера: её нажатие вызывает контекстное меню. */
+var SECONDARY_BUTTON = 2;
+/** Системная выноска iOS на долгое касание — ссылки, картинки: её место занимает меню. */
+var CALLOUT = "-webkit-touch-callout";
+/**
+* TMenuContextStrategy — контекстное меню области (`openOn: 'contextmenu'`):
+* панель встаёт у точки вызова.
+*
+* **Вызов — `contextmenu` на корне.** Его шлёт браузер на правую кнопку мыши,
+* на долгое касание (Android) и с клавиатуры — на клавишу контекстного меню и
+* Shift+F10 элементу под фокусом, с точкой у него. `preventDefault` убирает
+* системное меню, и `contextmenu`, уже погашенное (вложенное контекстное
+* меню вызвали раньше), не трогается: вызов один. Вызов у открытого меню
+* переставляет панель к новой точке, а не закрывает и открывает её заново.
+*
+* **Чем вызвали**, плагин узнаёт по нажатию в области: перед `contextmenu`
+* указателя было `pointerdown`, клавиатуры — `keydown`. Вызов клавишей
+* открывает меню на первом пункте, как кнопку с клавиатуры, указателем —
+* фокус на панели. Своего признака в событии нет: у вызова с клавиатуры
+* Chromium отдаёт `pointerType` мыши. Нажатия в области не было вовсе
+* (меню вызвала ассистивная технология) — вызов клавишей.
+*
+* **Долгое касание** — свой таймер только там, где браузер `contextmenu` на
+* него не шлёт: на сенсорных устройствах Apple (`isAppleTouch`). Палец или
+* перо, ушедшие дальше порога, — прокрутка, и вызова нет; второй палец —
+* масштаб, тоже. Браузер, приславший `contextmenu` раньше таймера, таймер
+* снимает: вызов один. Системное меню долгого касания там — выноска над
+* ссылкой и картинкой, и `preventDefault` её не убирает: её снимает
+* `-webkit-touch-callout: none` на корне, пока стратегия стоит, а потом
+* возвращается прежнее инлайновое значение. Ставит его стратегия, а не тема:
+* без него не работает поведение, а не вид, — как `touch-action` у
+* `TSwipePlugin`.
+*
+* **Нажатие в области мимо вызова закрывает меню**: область — не кнопка, и
+* нажатие на неё — то же, что нажатие мимо. Мышь — на `pointerdown`, как у
+* `TDismissPlugin`, кроме второй кнопки: за ней придёт `contextmenu`, и
+* панель переедет. Палец и перо — на `pointerup` того же нажатия: с нажатия
+* начинается и прокрутка, и долгое касание, которое меню переставит.
+* `TDismissPlugin` эти нажатия мимо не считает: корень — внутри владельца,
+* — поэтому решает их стратегия, знающая, где вызов.
+*/
+var TMenuContextStrategy = class {
+	/** Узел нужен под слушатели и под документ, чьё устройство спрашиваем. */
+	_root;
+	_host;
+	/** Долгое касание — своё: браузер `contextmenu` на него не шлёт. */
+	_longPress;
+	/** Последнее нажатие в области — клавиша, а не указатель. */
+	_byKeyboard = true;
+	/** Нажатие пальцем или пером, которое ещё решается. */
+	_press = null;
+	/** Инлайновая выноска корня до стратегии; `null` — стратегия её не трогала. */
+	_callout = null;
+	constructor(root, host) {
+		this._root = root;
+		this._host = host;
+		this._longPress = isAppleTouch(root.ownerDocument.defaultView?.navigator);
+		if (this._longPress && isMeasurableElement(root)) {
+			this._callout = root.style.getPropertyValue(CALLOUT);
+			root.style.setProperty(CALLOUT, "none");
+		}
+		const target = root;
+		target.addEventListener("contextmenu", this._onContextMenu);
+		target.addEventListener("keydown", this._onKeyDown, true);
+		target.addEventListener("pointerdown", this._onPointerDown, true);
+		target.addEventListener("pointermove", this._onPointerMove);
+		target.addEventListener("pointerup", this._onPointerUp);
+		target.addEventListener("pointercancel", this._onPointerCancel);
+	}
+	destroy() {
+		this._dropPress();
+		this._restoreCallout();
+		const target = this._root;
+		target.removeEventListener("contextmenu", this._onContextMenu);
+		target.removeEventListener("keydown", this._onKeyDown, true);
+		target.removeEventListener("pointerdown", this._onPointerDown, true);
+		target.removeEventListener("pointermove", this._onPointerMove);
+		target.removeEventListener("pointerup", this._onPointerUp);
+		target.removeEventListener("pointercancel", this._onPointerCancel);
+	}
+	/** Вернуть корню инлайновую выноску, что была до стратегии: пустая — снять свойство. */
+	_restoreCallout() {
+		const root = this._root;
+		const callout = this._callout;
+		if (callout === null || !isMeasurableElement(root)) return;
+		this._callout = null;
+		if (callout === "") root.style.removeProperty(CALLOUT);
+		else root.style.setProperty(CALLOUT, callout);
+	}
+	_onContextMenu = (event) => {
+		if (event.defaultPrevented) return;
+		event.preventDefault();
+		this._settlePress();
+		this._host.invoke({
+			x: event.clientX,
+			y: event.clientY
+		}, this._byKeyboard);
+	};
+	_onKeyDown = () => {
+		this._byKeyboard = true;
+	};
+	_onPointerDown = (event) => {
+		this._byKeyboard = false;
+		this._dropPress();
+		if (event.pointerType === "mouse") {
+			if (event.button !== SECONDARY_BUTTON && this._host.isOpen) this._host.close();
+			return;
+		}
+		if (!event.isPrimary) return;
+		const closes = this._host.isOpen && event.button !== SECONDARY_BUTTON;
+		if (!closes && !this._longPress) return;
+		this._press = {
+			pointerId: event.pointerId,
+			x: event.clientX,
+			y: event.clientY,
+			closes,
+			timer: this._longPress ? setTimeout(this._onLongPress, LONG_PRESS_DELAY) : null
+		};
+	};
+	/** Палец ушёл дальше порога — это прокрутка: ни вызова, ни закрытия. */
+	_onPointerMove = (event) => {
+		const press = this._press;
+		if (!press || event.pointerId !== press.pointerId) return;
+		if (Math.hypot(event.clientX - press.x, event.clientY - press.y) > LONG_PRESS_SLOP) this._dropPress();
+	};
+	/** Отпустили, не вызвав меню, — нажатие в области у открытого меню закрывает его. */
+	_onPointerUp = (event) => {
+		const press = this._press;
+		if (!press || event.pointerId !== press.pointerId) return;
+		this._dropPress();
+		if (press.closes && this._host.isOpen) this._host.close();
+	};
+	/** Браузер забрал касание под прокрутку или жест — решать нечего. */
+	_onPointerCancel = (event) => {
+		if (event.pointerId === this._press?.pointerId) this._dropPress();
+	};
+	/** Палец продержали — вызов у точки нажатия. */
+	_onLongPress = () => {
+		const press = this._press;
+		if (!press) return;
+		this._settlePress();
+		this._host.invoke({
+			x: press.x,
+			y: press.y
+		}, false);
+	};
+	/** Нажатие стало вызовом: таймер снят, отпускание меню не закроет. */
+	_settlePress() {
+		const press = this._press;
+		if (!press) return;
+		if (press.timer !== null) clearTimeout(press.timer);
+		press.timer = null;
+		press.closes = false;
+	}
+	/** Нажатия больше нет: таймер снят. */
+	_dropPress() {
+		const press = this._press;
+		if (press && press.timer !== null) clearTimeout(press.timer);
+		this._press = null;
+	}
+};
+//#endregion
+export { TMenuContextStrategy };

package/dist/custom/menu/pointer/strategies/index.d.ts

@@ -0,0 +1,3 @@
+export { TMenuPressStrategy } from './press.strategy';
+export { TMenuContextStrategy } from './context.strategy';
+export type { IMenuOpenHost, IMenuOpenStrategy, TMenuOpenStrategyCtor, TMenuContextPress, } from './types';

package/dist/custom/menu/pointer/strategies/press.strategy.d.ts

@@ -0,0 +1,23 @@
+import type { IMenuOpenHost, IMenuOpenStrategy } from './types';
+/**
+ * TMenuPressStrategy — меню у кнопки (`openOn: 'press'`): клик по корню
+ * переключает меню.
+ *
+ * В корне лежит только триггер (слот `trigger`), поэтому клик по корню — клик
+ * по триггеру, чем бы потребитель его ни нарисовал. Клик из Enter и пробела
+ * на `<button>` браузер делает сам, но до него не доходит: эти клавиши берёт
+ * клавиатура меню — открыть на первом пункте. По открытому триггеру клик
+ * закрывает меню без мигания: корень — внутри владельца, и `pointerdown`
+ * перед кликом `TDismissPlugin` мимо не считает.
+ *
+ * `contextmenu` над кнопкой не трогается: контекстного меню у неё нет, и
+ * браузер показывает своё.
+ */
+export declare class TMenuPressStrategy implements IMenuOpenStrategy {
+    /** Узел нужен только под слушатель — отсюда и тип. */
+    private readonly _root;
+    private readonly _host;
+    constructor(root: Element, host: IMenuOpenHost);
+    destroy(): void;
+    private readonly _onClick;
+}

package/dist/custom/menu/pointer/strategies/press.strategy.js

@@ -0,0 +1,33 @@
+//#region src/custom/menu/pointer/strategies/press.strategy.ts
+/**
+* TMenuPressStrategy — меню у кнопки (`openOn: 'press'`): клик по корню
+* переключает меню.
+*
+* В корне лежит только триггер (слот `trigger`), поэтому клик по корню — клик
+* по триггеру, чем бы потребитель его ни нарисовал. Клик из Enter и пробела
+* на `<button>` браузер делает сам, но до него не доходит: эти клавиши берёт
+* клавиатура меню — открыть на первом пункте. По открытому триггеру клик
+* закрывает меню без мигания: корень — внутри владельца, и `pointerdown`
+* перед кликом `TDismissPlugin` мимо не считает.
+*
+* `contextmenu` над кнопкой не трогается: контекстного меню у неё нет, и
+* браузер показывает своё.
+*/
+var TMenuPressStrategy = class {
+	/** Узел нужен только под слушатель — отсюда и тип. */
+	_root;
+	_host;
+	constructor(root, host) {
+		this._root = root;
+		this._host = host;
+		this._root.addEventListener("click", this._onClick);
+	}
+	destroy() {
+		this._root.removeEventListener("click", this._onClick);
+	}
+	_onClick = () => {
+		this._host.toggle();
+	};
+};
+//#endregion
+export { TMenuPressStrategy };

package/dist/custom/menu/pointer/strategies/types.d.ts

@@ -0,0 +1,49 @@
+import type { TMenuPoint } from '@soxa-ui/core';
+/**
+ * Срез плагина открытия, который видят стратегии: что они делают с меню.
+ *
+ * Стратегия знает свои события на корне, а не меню и не соседние плагины:
+ * открывает, переставляет и закрывает она через плагин, и подсветку при
+ * открытии клавишей решает он.
+ */
+export interface IMenuOpenHost {
+    /** Открыто ли меню. */
+    readonly isOpen: boolean;
+    /** Переключить меню — нажатие кнопки. */
+    toggle(): void;
+    /**
+     * Вызвать меню у точки окна, открытое — переставить к ней. Вызвали
+     * клавишей (`byKeyboard`) — подсвечен первый пункт, и фокус на нём, как у
+     * кнопки с клавиатуры; указателем — фокус на панели.
+     */
+    invoke(point: TMenuPoint, byKeyboard: boolean): void;
+    /** Закрыть меню. */
+    close(): void;
+}
+/**
+ * Способ открытия меню на его корне — по стратегии на режим `openOn`. Живёт,
+ * пока не сменились режим или корень: слушатели ставит конструктор, снимает
+ * `destroy()`.
+ */
+export interface IMenuOpenStrategy {
+    /** Снять слушатели корня и отменить отложенное. */
+    destroy(): void;
+}
+/** Конструктор стратегии: плагин заводит её на корень по режиму владельца. */
+export type TMenuOpenStrategyCtor = new (root: Element, host: IMenuOpenHost) => IMenuOpenStrategy;
+/**
+ * Нажатие пальцем или пером в области контекстного меню, которое ещё не
+ * решено: долгое — вызов, короткое у открытого меню — закрытие, ушедшее
+ * дальше порога — прокрутка, и ни то ни другое.
+ */
+export type TMenuContextPress = {
+    /** `pointerId` нажатия: чужие указатели его не решают */
+    pointerId: number;
+    /** Точка нажатия в координатах окна — у неё встанет меню */
+    x: number;
+    y: number;
+    /** Короткое нажатие закроет меню: оно было открыто, и вызовом нажатие не стало */
+    closes: boolean;
+    /** Таймер долгого касания; `null` — не ждём: своего вызова нет или он был */
+    timer: ReturnType<typeof setTimeout> | null;
+};

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

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

package/dist/custom/menu/popover-item-focus/focus.plugin.d.ts

@@ -0,0 +1,54 @@
+import { TPopoverFocusPlugin } from '../../popover/focus';
+import type { TMenuPopoverItemFocusPluginEvents } from './types';
+/**
+ * TMenuPopoverItemFocusPlugin — модель фокуса пункта меню с панелью
+ * (`Menu.PopoverItem`): панель — немодальный диалог у строки пункта.
+ *
+ * Немодальная, как у Popover, и от него наследует всё общее: запомнить,
+ * откуда открыли, кадром позже увести фокус на первую остановку панели (её
+ * нет — на саму панель), вернуть его при закрытии, закрыться по Escape и не
+ * возвращать фокус после нажатия и фокуса мимо. Tab ходит по тем же
+ * правилам — будто панель стоит в документе сразу за триггером. Своё у пункта
+ * — четыре вещи:
+ *
+ * - **триггер — строка пункта.** Её открывают нажатием, клавишами и
+ *   указателем, и фокус она держит сама (`tabindex="-1"` пишет коллекция), но
+ *   остановки Tab у неё нет — у меню их нет вовсе. Поэтому остановки триггера
+ *   здесь — сама строка: Tab с неё у открытой панели ведёт в панель,
+ *   Shift+Tab с первой остановки панели — на неё, панель открыта, а Escape в
+ *   панели возвращает фокус на неё;
+ * - **кто открыл.** Нажатие строки и клавиши ведут фокус в панель, а панель,
+ *   открытая наведением, фокус не берёт: он остаётся на строке
+ *   (`keepFocusOnRow`), и в панель его ведут нажатие в ней, Tab и стрелка к
+ *   концу строки (`focusPanel`). Кто открыл, знает указатель меню
+ *   (`TMenuHoverPlugin`), а не модель фокуса: она отдаёт две операции над
+ *   текущим открытием и между открытиями ничего не помнит;
+ * - **Tab с последней остановки панели** закрывает все меню (APG) и ведёт к
+ *   остановке за корнем меню. Корня меню пункт не знает, поэтому сообщает о
+ *   Tab меню над собой (`tab`), а то — дальше, до корня (`TMenuFocusPlugin`),
+ *   который закрывается и ведёт фокус, как Tab из своей панели. Фокус пункт
+ *   после этого не возвращает: он уходит за меню;
+ * - **возвращать ли фокус.** Только пока фокус в пункте или нигде
+ *   (`holdsFocus`): панель, закрытая вместе с меню, не тянет его на строку
+ *   спрятанной панели — меню уже вернуло его на триггер.
+ */
+export declare class TMenuPopoverItemFocusPlugin extends TPopoverFocusPlugin<TMenuPopoverItemFocusPluginEvents> {
+    /**
+     * Фокус остаётся на строке — в этом открытии: кадр, которым он ушёл бы в
+     * панель, снят. Зовёт указатель меню, открывший панель наведением. Панель
+     * закрыта — ничего: следующее открытие поведёт фокус в панель, как обычно.
+     */
+    keepFocusOnRow(): void;
+    /**
+     * Фокус — в открытую панель сейчас: на первую остановку, без неё — на саму
+     * панель. Зовёт стрелка к концу строки на строке открытого пункта
+     * (`TMenuPopoverItemKeyboardPlugin`). Панель закрыта — ничего.
+     */
+    focusPanel(): void;
+    /** Триггер — строка пункта: остановки Tab у неё нет, и среди остановок корня её не найти. */
+    protected _triggerStops(root: Element): Element[];
+    /** Tab из панели наружу — меню над пунктом: куда вести фокус, решает корень. */
+    protected _tabOutOfPanel(event: KeyboardEvent): void;
+    /** Возвращать фокус, только пока он в пункте или нигде. */
+    protected _returnsFocus(root: Element): boolean;
+}

package/dist/custom/menu/popover-item-focus/focus.plugin.js

@@ -0,0 +1,70 @@
+import { rowIn } from "../../list/row.js";
+import { TPopoverFocusPlugin } from "../../popover/focus/focus.plugin.js";
+import { holdsFocus } from "../nested-layer.js";
+//#region src/custom/menu/popover-item-focus/focus.plugin.ts
+/**
+* TMenuPopoverItemFocusPlugin — модель фокуса пункта меню с панелью
+* (`Menu.PopoverItem`): панель — немодальный диалог у строки пункта.
+*
+* Немодальная, как у Popover, и от него наследует всё общее: запомнить,
+* откуда открыли, кадром позже увести фокус на первую остановку панели (её
+* нет — на саму панель), вернуть его при закрытии, закрыться по Escape и не
+* возвращать фокус после нажатия и фокуса мимо. Tab ходит по тем же
+* правилам — будто панель стоит в документе сразу за триггером. Своё у пункта
+* — четыре вещи:
+*
+* - **триггер — строка пункта.** Её открывают нажатием, клавишами и
+*   указателем, и фокус она держит сама (`tabindex="-1"` пишет коллекция), но
+*   остановки Tab у неё нет — у меню их нет вовсе. Поэтому остановки триггера
+*   здесь — сама строка: Tab с неё у открытой панели ведёт в панель,
+*   Shift+Tab с первой остановки панели — на неё, панель открыта, а Escape в
+*   панели возвращает фокус на неё;
+* - **кто открыл.** Нажатие строки и клавиши ведут фокус в панель, а панель,
+*   открытая наведением, фокус не берёт: он остаётся на строке
+*   (`keepFocusOnRow`), и в панель его ведут нажатие в ней, Tab и стрелка к
+*   концу строки (`focusPanel`). Кто открыл, знает указатель меню
+*   (`TMenuHoverPlugin`), а не модель фокуса: она отдаёт две операции над
+*   текущим открытием и между открытиями ничего не помнит;
+* - **Tab с последней остановки панели** закрывает все меню (APG) и ведёт к
+*   остановке за корнем меню. Корня меню пункт не знает, поэтому сообщает о
+*   Tab меню над собой (`tab`), а то — дальше, до корня (`TMenuFocusPlugin`),
+*   который закрывается и ведёт фокус, как Tab из своей панели. Фокус пункт
+*   после этого не возвращает: он уходит за меню;
+* - **возвращать ли фокус.** Только пока фокус в пункте или нигде
+*   (`holdsFocus`): панель, закрытая вместе с меню, не тянет его на строку
+*   спрятанной панели — меню уже вернуло его на триггер.
+*/
+var TMenuPopoverItemFocusPlugin = class extends TPopoverFocusPlugin {
+	/**
+	* Фокус остаётся на строке — в этом открытии: кадр, которым он ушёл бы в
+	* панель, снят. Зовёт указатель меню, открывший панель наведением. Панель
+	* закрыта — ничего: следующее открытие поведёт фокус в панель, как обычно.
+	*/
+	keepFocusOnRow() {
+		this._cancelFocusFrame();
+	}
+	/**
+	* Фокус — в открытую панель сейчас: на первую остановку, без неё — на саму
+	* панель. Зовёт стрелка к концу строки на строке открытого пункта
+	* (`TMenuPopoverItemKeyboardPlugin`). Панель закрыта — ничего.
+	*/
+	focusPanel() {
+		this._focusPanel();
+	}
+	/** Триггер — строка пункта: остановки Tab у неё нет, и среди остановок корня её не найти. */
+	_triggerStops(root) {
+		const row = rowIn(root);
+		return row ? [row] : [];
+	}
+	/** Tab из панели наружу — меню над пунктом: куда вести фокус, решает корень. */
+	_tabOutOfPanel(event) {
+		this._restore = false;
+		this.events.emit("tab", event);
+	}
+	/** Возвращать фокус, только пока он в пункте или нигде. */
+	_returnsFocus(root) {
+		return holdsFocus(root, this._dismiss);
+	}
+};
+//#endregion
+export { TMenuPopoverItemFocusPlugin };

package/dist/custom/menu/popover-item-focus/index.d.ts

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

package/dist/custom/menu/popover-item-focus/types.d.ts

@@ -0,0 +1,10 @@
+import type { TPopoverFocusPluginEvents } from '../../popover/focus';
+export type TMenuPopoverItemFocusPluginEvents = TPopoverFocusPluginEvents & {
+    /**
+     * Tab с последней остановки панели пункта: меню закрывается целиком, и
+     * фокус уходит к остановке за его корнем, как Tab из панели меню (APG
+     * Menu). Куда — знает только корень, поэтому пункт сообщает о Tab меню над
+     * собой, а корень гасит клавишу, если повёл фокус сам
+     */
+    tab: (event: KeyboardEvent) => void;
+};

package/dist/custom/menu/popover-item-keyboard/index.d.ts

@@ -0,0 +1,2 @@
+export { TMenuPopoverItemKeyboardPlugin } from './keyboard.plugin';
+export type { TMenuPopoverItemKeyboardPluginEvents } from './types';

package/dist/custom/menu/popover-item-keyboard/keyboard.plugin.d.ts

@@ -0,0 +1,43 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TMenuPopoverItemKeyboardPluginEvents } from './types';
+/**
+ * TMenuPopoverItemKeyboardPlugin — клавиатура строки пункта меню с панелью
+ * (`Menu.PopoverItem`, APG Menu: пункт со всплывающим окном).
+ *
+ * Стрелка к концу строки (в RTL ←) открывает панель, как у подменю, и
+ * гасится: меню над пунктом погашенную клавишу не трогает
+ * (`TMenuNavigationPlugin`). Фокус в панель уводит модель фокуса пункта — и
+ * после клавиши, и после клика. Панель уже открыта — её открыл указатель, и
+ * фокус остался на строке, — та же стрелка ведёт фокус в неё: модель фокуса
+ * пункта, взятая при установке (`focusPanel`). Так в открытую наведением
+ * панель с клавиатуры ведёт не только Tab, но и стрелка, как в подменю.
+ * Enter и пробел своих правил не требуют: строка — `Button` на `div`, и клик
+ * из них делает её `TActionPlugin`, а клик строки открывает панель —
+ * открытую не закрывает и фокус не двигает.
+ *
+ * Строка лежит в корне пункта, поэтому клавиши слушает корень, — и только со
+ * строки: клавиши содержимого слотов строки им и принадлежат. Сторона строки
+ * — по направлению письма меню, в котором стоит пункт.
+ *
+ * Выключенный пункт панель не открывает. Подсвеченным он не бывает, и фокуса
+ * на его строке с клавиатуры нет, — проверка на случай фокуса, который
+ * поставили кликом.
+ */
+export declare class TMenuPopoverItemKeyboardPlugin extends TBasePlugin<any, TMenuPopoverItemKeyboardPluginEvents> {
+    private _item;
+    /** Модель фокуса пункта: ведёт фокус в уже открытую панель. */
+    private _focus;
+    /** Корень пункта — узел пункта в меню; строка лежит в нём. */
+    private _root;
+    /** Тот же корень — под слушатель клавиш. */
+    private _target;
+    install(ctx: IPluginContext, options?: unknown): void;
+    destroy(): void;
+    private _listen;
+    private _unlisten;
+    /** Стрелка к концу строки на строке пункта — открыть панель, а открытую — фокус в неё. */
+    private readonly _onKeyDown;
+    /** Стрелка к концу строки — по направлению строки пункта. */
+    private _toEnd;
+}