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

package/dist/custom/overlay/types.d.ts

@@ -0,0 +1,40 @@
+import type { TCloseReason } from '@soxa-ui/core';
+/** Опции привязки плагина оверлея к открытости владельца. */
+export interface IOverlayOpenOptions {
+    /**
+     * Свойство инстанса, которым выражена открытость.
+     *
+     * `null` отключает привязку: плагин не узнаёт об открытии и не закрывает
+     * владельца. По умолчанию `open` — так открытость называют и `TPopover`,
+     * и `TSelect`. У модального окна открытость — `visible`: оно само и есть
+     * слой.
+     */
+    property?: string | null;
+    /** Событие, по которому плагин перечитывает открытость. */
+    event?: string;
+}
+/**
+ * Открытость владельца глазами плагина оверлея: прочитать, записать и
+ * отвязаться.
+ */
+export interface IOverlayOpenState {
+    /** Whether the configured property is open and the owner is visible. */
+    read(): boolean;
+    /**
+     * Записать открытость владельцу. Так оверлей закрывает сам себя, когда
+     * закрытие — не решение пользователя: Tab увёл фокус из панели Popover.
+     */
+    write(value: boolean): void;
+    /**
+     * Пользователь закрывает владельца — нажатием мимо или Escape. Владельца,
+     * который принимает запрос (`requestClose`), плагин закрывает запросом с
+     * причиной: закрыться ли, решает он сам. Остальных — записью, как `write`.
+     */
+    close(reason: TCloseReason): void;
+    /**
+     * Снять подписку на открытость с шины владельца: `onChange` привязки
+     * больше не зовётся. Плагин зовёт это в `destroy()` — владелец переживает
+     * плагин, когда приложение передаёт свой `ctrl`.
+     */
+    unbind(): void;
+}

package/dist/custom/pagination/current.d.ts

@@ -0,0 +1,24 @@
+import type { IPagination, TPaginationCollection } from '@soxa-ui/core';
+import type { IPluginContext } from '../../base';
+import { TCollectionElements } from '../collection';
+/**
+ * Кнопка текущей страницы — страницы с ключом значения пагинации среди
+ * страниц коллекции, пока её узел в документе. `null` — страницы значения в
+ * коллекции нет (ключ без страницы) или её узла нет в документе.
+ *
+ * Текущая — по ключу, а не по активации: расширение `pagination` слушает того
+ * же владельца и пересобирает окно и активацию, бывает, позже того, кто
+ * спрашивает. Кнопка — первая `button` в узле страницы: корень страницы —
+ * место в списке (`li`), а кнопкой является строка внутри.
+ *
+ * Одна на фокус со стрелки, погасшей у края (`TPaginationFocusPlugin`), и
+ * узел фокуса пагинации (`currentPageOf`): текущую оба ищут одним правилом.
+ */
+export declare function currentButtonOf(owner: IPagination, engine: TPaginationCollection | null, elements: TCollectionElements | null): HTMLButtonElement | null;
+/**
+ * Узел фокуса Pagination (`focusTarget` плагина действия) — кнопка текущей
+ * страницы: корень пагинации — `nav`, ориентир без своей остановки, а
+ * остановки у неё — стрелки и страницы, и место пользователя в ряду —
+ * текущая. `null` — текущей страницы нет в коллекции или в документе.
+ */
+export declare function currentPageOf(_root: Element, ctx: IPluginContext): Element | null;

package/dist/custom/pagination/current.js

@@ -0,0 +1,34 @@
+import { TCollectionElements } from "../collection/collection-elements.plugin.js";
+//#region src/custom/pagination/current.ts
+/**
+* Кнопка текущей страницы — страницы с ключом значения пагинации среди
+* страниц коллекции, пока её узел в документе. `null` — страницы значения в
+* коллекции нет (ключ без страницы) или её узла нет в документе.
+*
+* Текущая — по ключу, а не по активации: расширение `pagination` слушает того
+* же владельца и пересобирает окно и активацию, бывает, позже того, кто
+* спрашивает. Кнопка — первая `button` в узле страницы: корень страницы —
+* место в списке (`li`), а кнопкой является строка внутри.
+*
+* Одна на фокус со стрелки, погасшей у края (`TPaginationFocusPlugin`), и
+* узел фокуса пагинации (`currentPageOf`): текущую оба ищут одним правилом.
+*/
+function currentButtonOf(owner, engine, elements) {
+	const page = engine?.extensions.batch.items.find((item) => item.value === owner.value);
+	const element = page ? elements?.getElementByItem(page) : null;
+	return element?.isConnected ? element.querySelector("button") : null;
+}
+/**
+* Узел фокуса Pagination (`focusTarget` плагина действия) — кнопка текущей
+* страницы: корень пагинации — `nav`, ориентир без своей остановки, а
+* остановки у неё — стрелки и страницы, и место пользователя в ряду —
+* текущая. `null` — текущей страницы нет в коллекции или в документе.
+*/
+function currentPageOf(_root, ctx) {
+	const owner = ctx.getInstance();
+	const elements = ctx.get(TCollectionElements) ?? null;
+	const engine = elements?.engine ?? null;
+	return owner ? currentButtonOf(owner, engine, elements) : null;
+}
+//#endregion
+export { currentButtonOf, currentPageOf };

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

@@ -0,0 +1,57 @@
+import type { IPagination } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TPaginationFocusPluginEvents } from './types';
+/**
+ * TPaginationFocusPlugin — фокус со стрелки, погасшей под ним у края, — на
+ * текущую страницу.
+ *
+ * Стрелки — нативные кнопки. Листая с клавиатуры до первой или последней
+ * страницы, пользователь выключает стрелку, на которой стоит фокус, а
+ * выключенная кнопка фокус теряет: браузер сбрасывает его в начало документа,
+ * и пользователь клавиатуры и скринридера теряет место. Плагин переводит фокус
+ * на кнопку текущей страницы — как календарь отдаёт его остановке сетки,
+ * когда кнопка листания погасла у края, и как React Aria.
+ *
+ * **Синхронно, в том же событии.** Решает геттер (`prevDisabled`,
+ * `nextDisabled`), а не атрибут: плагин слушает поводы, от которых зависит
+ * выключенность стрелок, — `change:value`, `change:total`, `change:pageSize`,
+ * `change:pages`, — и уводит фокус раньше, чем разметка выключит стрелку, так
+ * что браузеру чинить уже нечего. `focusout`, наблюдатель за атрибутом и
+ * ожидание перерисовки опоздали бы: к их моменту фокус уже в начале
+ * документа. `change:disabled` плагин не слушает: у выключенной пагинации
+ * остановок нет — фокус переносить некуда, — а включение стрелку не гасит.
+ *
+ * **Текущая — по ключу**: страница с ключом `value` пагинации среди страниц
+ * коллекции, а не активная. Расширение `pagination` слушает того же
+ * владельца и пересобирает окно и активацию, бывает, уже после плагина — тогда
+ * активной была бы ещё прежняя страница. Ключ от порядка подписок не зависит:
+ * стрелка гаснет, когда текущая — первая или последняя, а они в окне всегда,
+ * так что страница уже в коллекции и её узел нарисован. Цена: плагин, который
+ * слышит смену раньше расширения, не видит отмены перехода в
+ * `item:activate:before` — значение вернулось к прежнему, стрелка снова
+ * включена, а фокус остаётся на крайней странице, куда листали.
+ *
+ * Фокус остаётся, где был, когда переносить его некуда: пагинация выключена,
+ * страницы значения нет в коллекции (ключ без страницы) или её узла нет в
+ * документе — страница только вошла в окно (`middleCount` 0, а данные
+ * сменились под фокусом). Узла страницы плагин не ждёт: стрелкой до края узел
+ * текущей есть всегда.
+ *
+ * Стрелки находят по классам владельца (`classes.resolve`) и только внутри
+ * его корня, кнопку текущей — по реестру узлов коллекции (`currentButtonOf`,
+ * тем же правилом, что узел фокуса пагинации).
+ */
+export declare class TPaginationFocusPlugin extends TBasePlugin<IPagination, TPaginationFocusPluginEvents> {
+    private _owner;
+    /** Корень пагинации: свои стрелки — только внутри него. */
+    private _root;
+    private _elements;
+    private _engine;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /** Стрелка под фокусом погасла — фокус на кнопку текущей страницы. */
+    private readonly _onChange;
+    /** Стрелка своего корня, в которой стоит фокус; фокус не на стрелке — `undefined`. */
+    private _arrowUnderFocus;
+}

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

@@ -0,0 +1,106 @@
+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 { currentButtonOf } from "../current.js";
+//#region src/custom/pagination/focus/focus.plugin.ts
+/** Стрелки — по частям разметки владельца (`__prev`, `__next`). */
+var ARROWS = ["prev", "next"];
+/** Погасла ли стрелка — по геттеру пагинации, а не по атрибуту разметки. */
+var ARROW_OFF = {
+	prev: (owner) => owner.prevDisabled,
+	next: (owner) => owner.nextDisabled
+};
+/**
+* TPaginationFocusPlugin — фокус со стрелки, погасшей под ним у края, — на
+* текущую страницу.
+*
+* Стрелки — нативные кнопки. Листая с клавиатуры до первой или последней
+* страницы, пользователь выключает стрелку, на которой стоит фокус, а
+* выключенная кнопка фокус теряет: браузер сбрасывает его в начало документа,
+* и пользователь клавиатуры и скринридера теряет место. Плагин переводит фокус
+* на кнопку текущей страницы — как календарь отдаёт его остановке сетки,
+* когда кнопка листания погасла у края, и как React Aria.
+*
+* **Синхронно, в том же событии.** Решает геттер (`prevDisabled`,
+* `nextDisabled`), а не атрибут: плагин слушает поводы, от которых зависит
+* выключенность стрелок, — `change:value`, `change:total`, `change:pageSize`,
+* `change:pages`, — и уводит фокус раньше, чем разметка выключит стрелку, так
+* что браузеру чинить уже нечего. `focusout`, наблюдатель за атрибутом и
+* ожидание перерисовки опоздали бы: к их моменту фокус уже в начале
+* документа. `change:disabled` плагин не слушает: у выключенной пагинации
+* остановок нет — фокус переносить некуда, — а включение стрелку не гасит.
+*
+* **Текущая — по ключу**: страница с ключом `value` пагинации среди страниц
+* коллекции, а не активная. Расширение `pagination` слушает того же
+* владельца и пересобирает окно и активацию, бывает, уже после плагина — тогда
+* активной была бы ещё прежняя страница. Ключ от порядка подписок не зависит:
+* стрелка гаснет, когда текущая — первая или последняя, а они в окне всегда,
+* так что страница уже в коллекции и её узел нарисован. Цена: плагин, который
+* слышит смену раньше расширения, не видит отмены перехода в
+* `item:activate:before` — значение вернулось к прежнему, стрелка снова
+* включена, а фокус остаётся на крайней странице, куда листали.
+*
+* Фокус остаётся, где был, когда переносить его некуда: пагинация выключена,
+* страницы значения нет в коллекции (ключ без страницы) или её узла нет в
+* документе — страница только вошла в окно (`middleCount` 0, а данные
+* сменились под фокусом). Узла страницы плагин не ждёт: стрелкой до края узел
+* текущей есть всегда.
+*
+* Стрелки находят по классам владельца (`classes.resolve`) и только внутри
+* его корня, кнопку текущей — по реестру узлов коллекции (`currentButtonOf`,
+* тем же правилом, что узел фокуса пагинации).
+*/
+var TPaginationFocusPlugin = class extends TBasePlugin {
+	_owner = null;
+	/** Корень пагинации: свои стрелки — только внутри него. */
+	_root = null;
+	_elements = null;
+	_engine = null;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance() ?? null;
+		this._elements = ctx.get(TCollectionElements) ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => {
+			this._root = element;
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._root = null;
+		});
+		ctx.get(TCollectionBundlesPlugin)?.events.on("engine:bound", (engine) => {
+			this._engine = engine;
+		});
+		const events = this._owner?.events;
+		this._listenTo(events, "change:value", this._onChange);
+		this._listenTo(events, "change:total", this._onChange);
+		this._listenTo(events, "change:pageSize", this._onChange);
+		this._listenTo(events, "change:pages", this._onChange);
+	}
+	destroy() {
+		this._owner = null;
+		this._root = null;
+		this._elements = null;
+		this._engine = null;
+		super.destroy();
+	}
+	/** Стрелка под фокусом погасла — фокус на кнопку текущей страницы. */
+	_onChange = () => {
+		const owner = this._owner;
+		const root = this._root;
+		if (!owner || !root || owner.disabled) return;
+		const arrow = this._arrowUnderFocus(owner, root);
+		if (arrow && ARROW_OFF[arrow](owner)) currentButtonOf(owner, this._engine, this._elements)?.focus();
+	};
+	/** Стрелка своего корня, в которой стоит фокус; фокус не на стрелке — `undefined`. */
+	_arrowUnderFocus(owner, root) {
+		const active = root.ownerDocument.activeElement;
+		if (!active) return void 0;
+		return ARROWS.find((arrow) => {
+			const button = active.closest(owner.classes.resolve(`__${arrow}`, { point: true }));
+			return button !== null && root.contains(button);
+		});
+	}
+};
+//#endregion
+export { TPaginationFocusPlugin };

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

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

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

@@ -0,0 +1,8 @@
+import type { TPluginEvents } from '../../../base';
+/**
+ * Своих событий у плагина нет: куда ушёл фокус, сообщает DOM, а листание —
+ * значение пагинации.
+ */
+export type TPaginationFocusPluginEvents = TPluginEvents;
+/** Стрелка пагинации — часть разметки владельца `__prev` или `__next`. */
+export type TPaginationArrow = 'prev' | 'next';

package/dist/custom/pagination/index.d.ts

@@ -0,0 +1,3 @@
+export * from './focus';
+export * from './names';
+export { currentPageOf } from './current';

package/dist/custom/pagination/names/index.d.ts

@@ -0,0 +1 @@
+export * from './names.plugin';

package/dist/custom/pagination/names/names.plugin.d.ts

@@ -0,0 +1,15 @@
+import type { IPagination } from '@soxa-ui/core';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/**
+ * TPaginationNamesPlugin — имена стрелок пагинации от локали: в `prevAria` и
+ * `nextAria`. Стрелка без текста для скринридера безымянна.
+ *
+ * Имени ряду плагин не пишет: что листают — таблицу, ленту, результаты
+ * поиска, — знает только приложение, и `nav` называет оно (`aria_label`,
+ * `aria_labelledBy`). Имя из локали рядом с ними дало бы одному имени два
+ * входа. Страницы называет их текст — номер или текст страницы.
+ */
+export declare class TPaginationNamesPlugin extends TNamesPlugin<IPagination> {
+    protected _name(owner: IPagination, translations: TTranslations): void;
+}

package/dist/custom/pagination/names/names.plugin.js

@@ -0,0 +1,19 @@
+import { TNamesPlugin } from "../../../locale/names.plugin.js";
+//#region src/custom/pagination/names/names.plugin.ts
+/**
+* TPaginationNamesPlugin — имена стрелок пагинации от локали: в `prevAria` и
+* `nextAria`. Стрелка без текста для скринридера безымянна.
+*
+* Имени ряду плагин не пишет: что листают — таблицу, ленту, результаты
+* поиска, — знает только приложение, и `nav` называет оно (`aria_label`,
+* `aria_labelledBy`). Имя из локали рядом с ними дало бы одному имени два
+* входа. Страницы называет их текст — номер или текст страницы.
+*/
+var TPaginationNamesPlugin = class extends TNamesPlugin {
+	_name(owner, translations) {
+		owner.prevAria.add("aria-label", translations.pagination.prev);
+		owner.nextAria.add("aria-label", translations.pagination.next);
+	}
+};
+//#endregion
+export { TPaginationNamesPlugin };

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

@@ -0,0 +1,69 @@
+import type { IPluginContext } from '../../../base';
+import { TOverlayFocusPlugin } from '../../overlay/focus';
+import type { IOverlayOpenOptions } from '../../overlay/types';
+import type { TPopoverFocusPluginEvents } from './types';
+/**
+ * TPopoverFocusPlugin — модель фокуса Popover, немодального диалога APG.
+ *
+ * Всё, что у оверлеев общее — запомнить, откуда открыли, увести фокус в
+ * панель кадром позже, вернуть его при закрытии, закрыть по Escape и
+ * погасить его `preventDefault`, — лежит в `TOverlayFocusPlugin`. Здесь
+ * остаётся то, чем немодальный оверлей отличается от модального: Tab,
+ * запасной возврат фокуса и закрытие без возврата.
+ *
+ * **Нажатие и уход фокуса мимо фокус не возвращают**: страница за панелью
+ * рабочая, и пользователь уже там, куда нажал. Об этом плагин узнаёт
+ * событием `dismiss` у `TDismissPlugin` — оно приходит до закрытия. У
+ * модального оверлея наоборот: страница за ним недоступна, и фокус
+ * возвращается при любом закрытии.
+ *
+ * **Tab** ведёт себя так, будто панель стоит в документе сразу за
+ * триггером, хотя телепортирована в конец `body`:
+ * - Tab с последней остановки корня при открытой панели — в панель;
+ * - Tab с последней остановки панели — к первой остановке после корня, и
+ *   поповер закрывается без возврата фокуса. Если после корня остановок нет —
+ *   закрывается так же, а Tab не гасится;
+ * - Shift+Tab с первой остановки панели или с неё самой — на триггер, панель
+ *   остаётся открытой.
+ *
+ * **Возврат фокуса**, когда запомненный элемент пропал, — на первую остановку
+ * корня, то есть на триггер: у немодального оверлея он всегда рядом.
+ *
+ * Панель внутри контейнера (`contained`) не телепортирована и лежит в самом
+ * корне, сразу за триггером, — Tab в неё и из неё идёт по документу сам.
+ * Остановки триггера поэтому — остановки корня без остановок панели.
+ *
+ * Поповер немодальный: ловушки фокуса, `aria-modal` и `inert` нет, страница
+ * за панелью доступна.
+ *
+ * Наследнику со своим триггером остаются две точки: что считать остановками
+ * триггера (`_triggerStops`) и что делает Tab с последней остановки панели
+ * (`_tabOutOfPanel`). Так модель фокуса пункта меню с панелью берёт эти
+ * правила Tab целиком: её триггер — строка пункта, а куда фокусу уйти из
+ * панели, решает меню над пунктом.
+ */
+export declare class TPopoverFocusPlugin<TEvents extends TPopoverFocusPluginEvents = TPopoverFocusPluginEvents> extends TOverlayFocusPlugin<TEvents> {
+    install(ctx: IPluginContext, options?: IOverlayOpenOptions): void;
+    /** Запомненный элемент пропал — фокус возвращается на триггер в корне. */
+    protected _returnCandidates(root: Element): readonly Element[];
+    /**
+     * Остановки триггера: откуда Tab ведёт в панель, куда Shift+Tab из неё
+     * возвращает и куда уходит фокус, когда запомненного элемента нет. У
+     * поповера это остановки корня, но не панели, когда она лежит в корне
+     * (`contained`). Наследник подставляет свой триггер.
+     */
+    protected _triggerStops(root: Element): Element[];
+    protected _onTab(event: KeyboardEvent): void;
+    /** Tab с последней остановки корня — в панель, как будто она стоит сразу за триггером. */
+    private _tabIntoPanel;
+    /** Shift+Tab с первой остановки панели или с неё самой — на триггер; панель остаётся открытой. */
+    private _tabBackFromPanel;
+    /** Tab с последней остановки панели или с неё самой, когда остановок нет, — наружу. */
+    private _tabForwardFromPanel;
+    /**
+     * Tab из панели наружу — к первой остановке после корня. Поповер
+     * закрывается без возврата фокуса: фокус уходит дальше по странице.
+     * Остановок после корня нет — Tab не гасится, фокус уводит браузер.
+     */
+    protected _tabOutOfPanel(event: KeyboardEvent, root: Element, panel: Element): void;
+}

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

@@ -0,0 +1,107 @@
+import { tabStops } from "../../../utils/tabStops.js";
+import { tabStopsAfter } from "../../../utils/tabStopsAfter.js";
+import { focusFirst } from "../../../utils/focusFirst.js";
+import { TDismissPlugin } from "../../dismiss/dismiss.plugin.js";
+import { TOverlayFocusPlugin } from "../../overlay/focus/focus.plugin.js";
+//#region src/custom/popover/focus/focus.plugin.ts
+/**
+* TPopoverFocusPlugin — модель фокуса Popover, немодального диалога APG.
+*
+* Всё, что у оверлеев общее — запомнить, откуда открыли, увести фокус в
+* панель кадром позже, вернуть его при закрытии, закрыть по Escape и
+* погасить его `preventDefault`, — лежит в `TOverlayFocusPlugin`. Здесь
+* остаётся то, чем немодальный оверлей отличается от модального: Tab,
+* запасной возврат фокуса и закрытие без возврата.
+*
+* **Нажатие и уход фокуса мимо фокус не возвращают**: страница за панелью
+* рабочая, и пользователь уже там, куда нажал. Об этом плагин узнаёт
+* событием `dismiss` у `TDismissPlugin` — оно приходит до закрытия. У
+* модального оверлея наоборот: страница за ним недоступна, и фокус
+* возвращается при любом закрытии.
+*
+* **Tab** ведёт себя так, будто панель стоит в документе сразу за
+* триггером, хотя телепортирована в конец `body`:
+* - Tab с последней остановки корня при открытой панели — в панель;
+* - Tab с последней остановки панели — к первой остановке после корня, и
+*   поповер закрывается без возврата фокуса. Если после корня остановок нет —
+*   закрывается так же, а Tab не гасится;
+* - Shift+Tab с первой остановки панели или с неё самой — на триггер, панель
+*   остаётся открытой.
+*
+* **Возврат фокуса**, когда запомненный элемент пропал, — на первую остановку
+* корня, то есть на триггер: у немодального оверлея он всегда рядом.
+*
+* Панель внутри контейнера (`contained`) не телепортирована и лежит в самом
+* корне, сразу за триггером, — Tab в неё и из неё идёт по документу сам.
+* Остановки триггера поэтому — остановки корня без остановок панели.
+*
+* Поповер немодальный: ловушки фокуса, `aria-modal` и `inert` нет, страница
+* за панелью доступна.
+*
+* Наследнику со своим триггером остаются две точки: что считать остановками
+* триггера (`_triggerStops`) и что делает Tab с последней остановки панели
+* (`_tabOutOfPanel`). Так модель фокуса пункта меню с панелью берёт эти
+* правила Tab целиком: её триггер — строка пункта, а куда фокусу уйти из
+* панели, решает меню над пунктом.
+*/
+var TPopoverFocusPlugin = class extends TOverlayFocusPlugin {
+	install(ctx, options) {
+		super.install(ctx, options);
+		ctx.get(TDismissPlugin)?.events.on("dismiss", () => {
+			this._restore = false;
+		});
+	}
+	/** Запомненный элемент пропал — фокус возвращается на триггер в корне. */
+	_returnCandidates(root) {
+		return this._triggerStops(root);
+	}
+	/**
+	* Остановки триггера: откуда Tab ведёт в панель, куда Shift+Tab из неё
+	* возвращает и куда уходит фокус, когда запомненного элемента нет. У
+	* поповера это остановки корня, но не панели, когда она лежит в корне
+	* (`contained`). Наследник подставляет свой триггер.
+	*/
+	_triggerStops(root) {
+		const panel = this._dismiss?.findPanel() ?? this._panel;
+		return tabStops(root).filter((stop) => !panel?.contains(stop));
+	}
+	_onTab(event) {
+		const root = this._root;
+		const panel = this._panel;
+		const active = root?.ownerDocument.activeElement;
+		if (!root || !panel || !active) return;
+		if (panel.contains(active)) {
+			if (event.shiftKey) this._tabBackFromPanel(event, root, panel, active);
+			else this._tabForwardFromPanel(event, root, panel, active);
+			return;
+		}
+		if (!event.shiftKey && root.contains(active)) this._tabIntoPanel(event, root, panel, active);
+	}
+	/** Tab с последней остановки корня — в панель, как будто она стоит сразу за триггером. */
+	_tabIntoPanel(event, root, panel, active) {
+		if (active !== this._triggerStops(root).at(-1)) return;
+		if (focusFirst([...tabStops(panel), panel])) event.preventDefault();
+	}
+	/** Shift+Tab с первой остановки панели или с неё самой — на триггер; панель остаётся открытой. */
+	_tabBackFromPanel(event, root, panel, active) {
+		if (active !== panel && active !== tabStops(panel)[0]) return;
+		if (focusFirst(this._triggerStops(root).reverse())) event.preventDefault();
+	}
+	/** Tab с последней остановки панели или с неё самой, когда остановок нет, — наружу. */
+	_tabForwardFromPanel(event, root, panel, active) {
+		if (active !== (tabStops(panel).at(-1) ?? panel)) return;
+		this._tabOutOfPanel(event, root, panel);
+	}
+	/**
+	* Tab из панели наружу — к первой остановке после корня. Поповер
+	* закрывается без возврата фокуса: фокус уходит дальше по странице.
+	* Остановок после корня нет — Tab не гасится, фокус уводит браузер.
+	*/
+	_tabOutOfPanel(event, root, panel) {
+		this._restore = false;
+		this._close();
+		if (focusFirst(tabStopsAfter(root, panel))) event.preventDefault();
+	}
+};
+//#endregion
+export { TPopoverFocusPlugin };

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

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

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

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

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

@@ -0,0 +1,18 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TPopoverIdsPlugin — связка «триггер ↔ панель» поповера в документе.
+ *
+ * `id` панели — в `aria` поповера, который разметка раскладывает на панель, и
+ * ссылка на него `aria-controls` — в `triggerAria` триггера. Обе стороны
+ * пишутся здесь, от одного `id`: формула одна на обе.
+ *
+ * `id` — от монтирования (`createId`), а не от экземпляра: он нужен только
+ * документу, и на сервере и в браузере обязан совпасть. Пишется при
+ * установке, синхронно, — связка есть уже в первой (и серверной) отрисовке.
+ * `aria-controls` стоит и у закрытой панели: она всегда в документе,
+ * закрытие её только прячет.
+ */
+export declare class TPopoverIdsPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

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

@@ -0,0 +1,27 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+//#region src/custom/popover/ids/ids.plugin.ts
+/**
+* TPopoverIdsPlugin — связка «триггер ↔ панель» поповера в документе.
+*
+* `id` панели — в `aria` поповера, который разметка раскладывает на панель, и
+* ссылка на него `aria-controls` — в `triggerAria` триггера. Обе стороны
+* пишутся здесь, от одного `id`: формула одна на обе.
+*
+* `id` — от монтирования (`createId`), а не от экземпляра: он нужен только
+* документу, и на сервере и в браузере обязан совпасть. Пишется при
+* установке, синхронно, — связка есть уже в первой (и серверной) отрисовке.
+* `aria-controls` стоит и у закрытой панели: она всегда в документе,
+* закрытие её только прячет.
+*/
+var TPopoverIdsPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const popover = ctx.getInstance();
+		if (!popover) return;
+		const panelId = ctx.createId("panel");
+		popover.aria.add("id", panelId);
+		popover.triggerAria.add("aria-controls", panelId);
+	}
+};
+//#endregion
+export { TPopoverIdsPlugin };

package/dist/custom/popover/ids/index.d.ts

@@ -0,0 +1 @@
+export * from './ids.plugin';

package/dist/custom/popover/index.d.ts

@@ -0,0 +1,4 @@
+export * from './pointer';
+export * from './focus';
+export * from './ids';
+export * from './names';

package/dist/custom/popover/names/index.d.ts

@@ -0,0 +1 @@
+export * from './names.plugin';

package/dist/custom/popover/names/names.plugin.d.ts

@@ -0,0 +1,7 @@
+import type { IPopover } from '@soxa-ui/core';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/** TPopoverNamesPlugin — имя кнопки закрытия поповера от локали: в `closeAria`. */
+export declare class TPopoverNamesPlugin extends TNamesPlugin<IPopover> {
+    protected _name(owner: IPopover, translations: TTranslations): void;
+}

package/dist/custom/popover/names/names.plugin.js

@@ -0,0 +1,10 @@
+import { TNamesPlugin } from "../../../locale/names.plugin.js";
+//#region src/custom/popover/names/names.plugin.ts
+/** TPopoverNamesPlugin — имя кнопки закрытия поповера от локали: в `closeAria`. */
+var TPopoverNamesPlugin = class extends TNamesPlugin {
+	_name(owner, translations) {
+		owner.closeAria.add("aria-label", translations.popover.close);
+	}
+};
+//#endregion
+export { TPopoverNamesPlugin };

package/dist/custom/popover/pointer/index.d.ts

@@ -0,0 +1,2 @@
+export { TPopoverPointerPlugin } from './pointer.plugin';
+export type { TPopoverPointerPluginEvents } from './types';