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

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

@@ -0,0 +1,150 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext, TPluginEvents } from '../../../base';
+import { TDismissPlugin } from '../../dismiss';
+import type { IOverlayOpenOptions } from '../types';
+/**
+ * TOverlayFocusPlugin — общая часть модели фокуса всего, что открывается
+ * поверх страницы.
+ *
+ * Одинаково у модального и немодального оверлея всё, кроме Tab: запомнить,
+ * откуда открыли, увести фокус в панель, вернуть его при закрытии и закрыться
+ * по Escape. Стратегий Tab две, и различаются они целиком, а не деталью:
+ * немодальная панель пропускает фокус дальше по странице
+ * (`TPopoverFocusPlugin`), модальная замыкает его в себе
+ * (`TModalFocusPlugin`). Поэтому здесь база, а не флаг `modal` в одном
+ * плагине. Третья модель — панель DatePicker (`TDatePickerFocusPlugin`): Tab
+ * замкнут, как у модальной (ловушка — общая утилита `trapTab`), а нажатие
+ * мимо фокус отпускает, как у немодальной.
+ *
+ * **Открытие.** Запоминает элемент, на котором был фокус, и кадром позже
+ * ставит фокус на первую остановку Tab в панели, а если её нет — на саму
+ * панель (`tabindex="-1"`). Кадр — потому что содержимое панели монтирует
+ * рендер адаптера, а он идёт после смены открытости. Оверлей, открытый со
+ * старта, обрабатывается так же, как только корень объявлен. Своё место
+ * первого фокуса наследник подставляет точкой `_focusCandidates`: панель
+ * DatePicker ставит его на день сетки, а не на первую кнопку календаря.
+ * Обе операции открытия наследнику доступны: снять кадр этого открытия
+ * (`_cancelFocusFrame`) — фокус остаётся, где был, — и увести фокус в
+ * открытую панель сейчас (`_focusPanel`). Так пункт меню с панелью оставляет
+ * фокус на строке, когда панель открыл указатель, и ведёт его в панель
+ * клавишей.
+ *
+ * **Закрытие.** Фокус возвращается на запомненный элемент, а если там был
+ * `body` или элемент уже отсоединён — на то, что подставит наследник
+ * (`_returnCandidates`). Годится ли запомненный элемент для возврата, тоже
+ * решает наследник (`_canReturnTo`): по умолчанию годится любой — так у
+ * Popover, Menu и модального окна, — а панель DatePicker на свою кнопку
+ * календаря фокус не возвращает, она возвращает его в поле. Не возвращать
+ * фокус вовсе (`_restore`) решает стратегия: у немодального оверлея нажатие
+ * и уход фокуса мимо — выбор пользователя, он уже там, куда нажал; у
+ * модального фокус возвращается при любом закрытии.
+ *
+ * **Escape** закрывает оверлей, если его ещё никто не обработал
+ * (`defaultPrevented`). Сам плагин гасит его `preventDefault`, а не
+ * `stopPropagation`: так Escape в открытом Select или во вложенной панели
+ * закрывает только их слой, а внешний видит, что клавиша уже потрачена.
+ * Закрывает с причиной `escape`: владелец, который принимает запрос закрытия
+ * (модальное окно), может его отклонить — клавиша всё равно потрачена, она
+ * адресована верхнему слою.
+ *
+ * Слушатели клавиш — на корне и на панели, пока оверлей открыт. Корень берёт
+ * у `TElementPlugin`, панель — у `TDismissPlugin`: панель телепортирована, и
+ * найти её можно только по его пометке владельцем. Панели по пометке нет (её
+ * не пометили или `TDismissPlugin` не поставлен) — подставляет её наследник
+ * (`_panelFallback`): у модального окна корень и есть панель, а у
+ * немодального панели просто нет.
+ */
+export declare abstract class TOverlayFocusPlugin<TEvents extends TPluginEvents = TPluginEvents> extends TBasePlugin<any, TEvents> {
+    /** Открытость владельца: по ней плагин включается и ею же закрывает. */
+    private _open;
+    protected _dismiss: TDismissPlugin | null;
+    /** Корень компонента — на нём висит слушатель клавиш. */
+    protected _root: Element | null;
+    /** Панель, найденная при открытии, — на ней тоже висит слушатель клавиш. */
+    protected _panel: Element | null;
+    /**
+     * Возвращать ли фокус при закрытии. Снимает стратегия — у немодального
+     * оверлея нажатие мимо, уход фокуса и Tab из панели.
+     */
+    protected _restore: boolean;
+    /** Узлы со слушателем клавиш: корень и панель, если это разные узлы. */
+    private _targets;
+    /** Открытие обработано: элемент возврата запомнен, фокус уводится в панель. */
+    private _engaged;
+    /** Элемент, на котором был фокус при открытии, — на него фокус вернётся. */
+    private _returnTo;
+    /** Кадр, в котором фокус уйдёт в панель; `null` — уводить некуда. */
+    private _focusFrame;
+    install(ctx: IPluginContext, options?: IOverlayOpenOptions): void;
+    destroy(): void;
+    /** Что делает Tab: наружу из панели у немодального, по кругу — у модального. */
+    protected abstract _onTab(event: KeyboardEvent): void;
+    /**
+     * Панель, когда её не нашлось по пометке владельца. У модального оверлея
+     * панель и есть корень, у немодального панели без пометки нет.
+     */
+    protected _panelFallback(_root: Element): Element | null;
+    /**
+     * Куда уводить фокус при открытии — по порядку, до первого, кто его примет:
+     * первая остановка Tab в панели, а если её нет — сама панель.
+     */
+    protected _focusCandidates(panel: Element): readonly Element[];
+    /**
+     * Годится ли запомненный элемент для возврата фокуса. По умолчанию — да:
+     * фокус возвращается туда, откуда открыли. Не годится — фокус уходит туда
+     * же, куда при пропавшем элементе (`_returnCandidates`).
+     */
+    protected _canReturnTo(_element: Element, _root: Element): boolean;
+    /**
+     * Куда вернуть фокус, когда запомненный элемент пропал или для возврата не
+     * годится (`_canReturnTo`). У немодального оверлея это триггер внутри
+     * корня, у модального возвращать некуда.
+     */
+    protected _returnCandidates(_root: Element): readonly Element[];
+    /**
+     * Возвращать ли фокус при этом закрытии — сверх того, что решила стратегия
+     * (`_restore`): у той ответ один на причину закрытия, а здесь наследник
+     * смотрит, где фокус сейчас. По умолчанию — да. Подменю отказывает, когда
+     * фокус уже не в нём: закрылось оно вместе с меню, а фокус меню вернуло на
+     * триггер, — и строка спрятанной панели его не перехватывает.
+     */
+    protected _returnsFocus(_root: Element): boolean;
+    /**
+     * Закрыть владельца записью — у немодального оверлея Tab из панели. Это
+     * не просьба пользователя закрыть: фокус ушёл дальше по странице, и
+     * держать панель открытой за ним незачем.
+     */
+    protected _close(): void;
+    /** Открытие: запомнить, куда вернуть фокус, увести его в панель, слушать клавиши. */
+    private _engage;
+    /** Закрытие: снять слушатели и вернуть фокус, если закрыло не нажатие мимо. */
+    private _release;
+    /**
+     * Фокус — в панель, на первого из кандидатов, кто его примет. Панели нет —
+     * оверлей закрыт или корня ещё нет — ничего.
+     *
+     * Окно к нему не прокручивается (`preventScroll`): место панели решает её
+     * раскладка, а не фокус. Кадр фокуса идёт раньше наблюдателей размера, и
+     * панель у якоря, которая лежит в документе, ещё стоит там, где её
+     * поставил расчёт по нулевой высоте, — под полем у нижнего края окна.
+     * Прокрутка к ней увела бы страницу, и панель осталась бы внизу, а не
+     * встала над полем.
+     */
+    protected _focusPanel(): void;
+    /**
+     * На запомненный элемент, если он годится для возврата (`_canReturnTo`),
+     * иначе — туда, куда указал наследник. `body` не в счёт: на нём фокус,
+     * когда его нет нигде (открыли не с клавиатуры и не кликом по кнопке), и
+     * вернуть его туда значило бы потерять.
+     */
+    private _returnFocus;
+    private _listen;
+    private _unlisten;
+    private readonly _onKeyDown;
+    /**
+     * Снять кадр, которым фокус уйдёт в панель при этом открытии: фокус
+     * остаётся, где был. Кадра нет — оверлей закрыт или фокус уже увели —
+     * ничего.
+     */
+    protected _cancelFocusFrame(): void;
+}

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

@@ -0,0 +1,242 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { tabStops } from "../../../utils/tabStops.js";
+import { focusFirst } from "../../../utils/focusFirst.js";
+import { bindOverlayOpen } from "../open-state.js";
+import { TDismissPlugin } from "../../dismiss/dismiss.plugin.js";
+//#region src/custom/overlay/focus/focus.plugin.ts
+/**
+* TOverlayFocusPlugin — общая часть модели фокуса всего, что открывается
+* поверх страницы.
+*
+* Одинаково у модального и немодального оверлея всё, кроме Tab: запомнить,
+* откуда открыли, увести фокус в панель, вернуть его при закрытии и закрыться
+* по Escape. Стратегий Tab две, и различаются они целиком, а не деталью:
+* немодальная панель пропускает фокус дальше по странице
+* (`TPopoverFocusPlugin`), модальная замыкает его в себе
+* (`TModalFocusPlugin`). Поэтому здесь база, а не флаг `modal` в одном
+* плагине. Третья модель — панель DatePicker (`TDatePickerFocusPlugin`): Tab
+* замкнут, как у модальной (ловушка — общая утилита `trapTab`), а нажатие
+* мимо фокус отпускает, как у немодальной.
+*
+* **Открытие.** Запоминает элемент, на котором был фокус, и кадром позже
+* ставит фокус на первую остановку Tab в панели, а если её нет — на саму
+* панель (`tabindex="-1"`). Кадр — потому что содержимое панели монтирует
+* рендер адаптера, а он идёт после смены открытости. Оверлей, открытый со
+* старта, обрабатывается так же, как только корень объявлен. Своё место
+* первого фокуса наследник подставляет точкой `_focusCandidates`: панель
+* DatePicker ставит его на день сетки, а не на первую кнопку календаря.
+* Обе операции открытия наследнику доступны: снять кадр этого открытия
+* (`_cancelFocusFrame`) — фокус остаётся, где был, — и увести фокус в
+* открытую панель сейчас (`_focusPanel`). Так пункт меню с панелью оставляет
+* фокус на строке, когда панель открыл указатель, и ведёт его в панель
+* клавишей.
+*
+* **Закрытие.** Фокус возвращается на запомненный элемент, а если там был
+* `body` или элемент уже отсоединён — на то, что подставит наследник
+* (`_returnCandidates`). Годится ли запомненный элемент для возврата, тоже
+* решает наследник (`_canReturnTo`): по умолчанию годится любой — так у
+* Popover, Menu и модального окна, — а панель DatePicker на свою кнопку
+* календаря фокус не возвращает, она возвращает его в поле. Не возвращать
+* фокус вовсе (`_restore`) решает стратегия: у немодального оверлея нажатие
+* и уход фокуса мимо — выбор пользователя, он уже там, куда нажал; у
+* модального фокус возвращается при любом закрытии.
+*
+* **Escape** закрывает оверлей, если его ещё никто не обработал
+* (`defaultPrevented`). Сам плагин гасит его `preventDefault`, а не
+* `stopPropagation`: так Escape в открытом Select или во вложенной панели
+* закрывает только их слой, а внешний видит, что клавиша уже потрачена.
+* Закрывает с причиной `escape`: владелец, который принимает запрос закрытия
+* (модальное окно), может его отклонить — клавиша всё равно потрачена, она
+* адресована верхнему слою.
+*
+* Слушатели клавиш — на корне и на панели, пока оверлей открыт. Корень берёт
+* у `TElementPlugin`, панель — у `TDismissPlugin`: панель телепортирована, и
+* найти её можно только по его пометке владельцем. Панели по пометке нет (её
+* не пометили или `TDismissPlugin` не поставлен) — подставляет её наследник
+* (`_panelFallback`): у модального окна корень и есть панель, а у
+* немодального панели просто нет.
+*/
+var TOverlayFocusPlugin = class extends TBasePlugin {
+	/** Открытость владельца: по ней плагин включается и ею же закрывает. */
+	_open = null;
+	_dismiss = null;
+	/** Корень компонента — на нём висит слушатель клавиш. */
+	_root = null;
+	/** Панель, найденная при открытии, — на ней тоже висит слушатель клавиш. */
+	_panel = null;
+	/**
+	* Возвращать ли фокус при закрытии. Снимает стратегия — у немодального
+	* оверлея нажатие мимо, уход фокуса и Tab из панели.
+	*/
+	_restore = true;
+	/** Узлы со слушателем клавиш: корень и панель, если это разные узлы. */
+	_targets = [];
+	/** Открытие обработано: элемент возврата запомнен, фокус уводится в панель. */
+	_engaged = false;
+	/** Элемент, на котором был фокус при открытии, — на него фокус вернётся. */
+	_returnTo = null;
+	/** Кадр, в котором фокус уйдёт в панель; `null` — уводить некуда. */
+	_focusFrame = null;
+	install(ctx, options) {
+		super.install(ctx, options);
+		this._dismiss = ctx.get(TDismissPlugin) ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => {
+			this._root = element;
+			if (this._open?.read()) this._engage();
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._unlisten();
+			this._root = null;
+		});
+		this._open = bindOverlayOpen(ctx, options, (open) => {
+			if (open) this._engage();
+			else this._release();
+		});
+	}
+	destroy() {
+		this._cancelFocusFrame();
+		this._unlisten();
+		this._open?.unbind();
+		this._open = null;
+		this._dismiss = null;
+		this._root = null;
+		this._returnTo = null;
+		super.destroy();
+	}
+	/**
+	* Панель, когда её не нашлось по пометке владельца. У модального оверлея
+	* панель и есть корень, у немодального панели без пометки нет.
+	*/
+	_panelFallback(_root) {
+		return null;
+	}
+	/**
+	* Куда уводить фокус при открытии — по порядку, до первого, кто его примет:
+	* первая остановка Tab в панели, а если её нет — сама панель.
+	*/
+	_focusCandidates(panel) {
+		return [...tabStops(panel), panel];
+	}
+	/**
+	* Годится ли запомненный элемент для возврата фокуса. По умолчанию — да:
+	* фокус возвращается туда, откуда открыли. Не годится — фокус уходит туда
+	* же, куда при пропавшем элементе (`_returnCandidates`).
+	*/
+	_canReturnTo(_element, _root) {
+		return true;
+	}
+	/**
+	* Куда вернуть фокус, когда запомненный элемент пропал или для возврата не
+	* годится (`_canReturnTo`). У немодального оверлея это триггер внутри
+	* корня, у модального возвращать некуда.
+	*/
+	_returnCandidates(_root) {
+		return [];
+	}
+	/**
+	* Возвращать ли фокус при этом закрытии — сверх того, что решила стратегия
+	* (`_restore`): у той ответ один на причину закрытия, а здесь наследник
+	* смотрит, где фокус сейчас. По умолчанию — да. Подменю отказывает, когда
+	* фокус уже не в нём: закрылось оно вместе с меню, а фокус меню вернуло на
+	* триггер, — и строка спрятанной панели его не перехватывает.
+	*/
+	_returnsFocus(_root) {
+		return true;
+	}
+	/**
+	* Закрыть владельца записью — у немодального оверлея Tab из панели. Это
+	* не просьба пользователя закрыть: фокус ушёл дальше по странице, и
+	* держать панель открытой за ним незачем.
+	*/
+	_close() {
+		this._open?.write(false);
+	}
+	/** Открытие: запомнить, куда вернуть фокус, увести его в панель, слушать клавиши. */
+	_engage() {
+		const root = this._root;
+		if (!root) return;
+		this._listen(root);
+		if (this._engaged) return;
+		this._engaged = true;
+		this._restore = true;
+		this._returnTo = root.ownerDocument.activeElement;
+		this._cancelFocusFrame();
+		this._focusFrame = requestAnimationFrame(() => {
+			this._focusFrame = null;
+			this._focusPanel();
+		});
+	}
+	/** Закрытие: снять слушатели и вернуть фокус, если закрыло не нажатие мимо. */
+	_release() {
+		this._cancelFocusFrame();
+		this._unlisten();
+		if (!this._engaged) return;
+		const root = this._root;
+		const returnTo = this._returnTo;
+		const restore = this._restore;
+		this._engaged = false;
+		this._returnTo = null;
+		this._restore = true;
+		if (restore && root && this._returnsFocus(root)) this._returnFocus(root, returnTo);
+	}
+	/**
+	* Фокус — в панель, на первого из кандидатов, кто его примет. Панели нет —
+	* оверлей закрыт или корня ещё нет — ничего.
+	*
+	* Окно к нему не прокручивается (`preventScroll`): место панели решает её
+	* раскладка, а не фокус. Кадр фокуса идёт раньше наблюдателей размера, и
+	* панель у якоря, которая лежит в документе, ещё стоит там, где её
+	* поставил расчёт по нулевой высоте, — под полем у нижнего края окна.
+	* Прокрутка к ней увела бы страницу, и панель осталась бы внизу, а не
+	* встала над полем.
+	*/
+	_focusPanel() {
+		const panel = this._panel;
+		if (panel) focusFirst(this._focusCandidates(panel), { preventScroll: true });
+	}
+	/**
+	* На запомненный элемент, если он годится для возврата (`_canReturnTo`),
+	* иначе — туда, куда указал наследник. `body` не в счёт: на нём фокус,
+	* когда его нет нигде (открыли не с клавиатуры и не кликом по кнопке), и
+	* вернуть его туда значило бы потерять.
+	*/
+	_returnFocus(root, returnTo) {
+		const doc = root.ownerDocument;
+		const remembered = returnTo && returnTo.isConnected && returnTo !== doc.body && returnTo !== doc.documentElement && this._canReturnTo(returnTo, root) ? [returnTo] : [];
+		focusFirst([...remembered, ...this._returnCandidates(root)]);
+	}
+	_listen(root) {
+		this._unlisten();
+		this._panel = this._dismiss?.findPanel() ?? this._panelFallback(root);
+		this._targets = this._panel && !root.contains(this._panel) ? [root, this._panel] : [root];
+		for (const target of this._targets) target.addEventListener("keydown", this._onKeyDown);
+	}
+	_unlisten() {
+		for (const target of this._targets) target.removeEventListener("keydown", this._onKeyDown);
+		this._targets = [];
+		this._panel = null;
+	}
+	_onKeyDown = (event) => {
+		if (event.defaultPrevented) return;
+		if (event.key === "Escape") {
+			event.preventDefault();
+			this._open?.close("escape");
+			return;
+		}
+		if (event.key === "Tab") this._onTab(event);
+	};
+	/**
+	* Снять кадр, которым фокус уйдёт в панель при этом открытии: фокус
+	* остаётся, где был. Кадра нет — оверлей закрыт или фокус уже увели —
+	* ничего.
+	*/
+	_cancelFocusFrame() {
+		if (this._focusFrame === null) return;
+		cancelAnimationFrame(this._focusFrame);
+		this._focusFrame = null;
+	}
+};
+//#endregion
+export { TOverlayFocusPlugin };

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

@@ -0,0 +1 @@
+export { TOverlayFocusPlugin } from './focus.plugin';

package/dist/custom/overlay/hide-outside/hide-outside.plugin.d.ts

@@ -0,0 +1,84 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { IHideOutsidePluginOptions, THideOutsidePluginEvents } from './types';
+/**
+ * THideOutsidePlugin — пока владелец открыт, фон под ним спрятан от
+ * скринридера.
+ *
+ * Вторая половина модальности. Фокус в модальной панели держит
+ * `TModalFocusPlugin`, но скринридер читает страницу и без фокуса — режимом
+ * чтения, стрелками. APG требует, чтобы фон модального окна был для него
+ * недоступен: `aria-modal="true"` на панели (его пишет ядро окна в свой
+ * `aria`) закрывает это только у современных скринридеров, а режим чтения
+ * браузера и старые AT уважают лишь пометку на самих узлах фона.
+ *
+ * **Пометка — `aria-hidden="true"`, а не `inert`.** `inert` отнимает у фона
+ * ещё и фокус, а фокусом владеет модель фокуса: при закрытии она сразу
+ * возвращает его в фон, и пока фон `inert`, `focus()` молча не срабатывает.
+ * Работа зависела бы от того, какой из двух плагинов раньше узнал о
+ * закрытии. Здесь — только то, что видит скринридер.
+ *
+ * **Что остаётся доступным.** Панель — узел с пометкой владельцем
+ * (`TDismissPlugin.findPanel()`), а без неё корень: у модального окна корень
+ * телепортирован целиком (то же правило, что у `TModalFocusPlugin`). И
+ * слои, открытые поверх панели: список Select в окне — тоже панель в `body`,
+ * соседка окна, а не его потомок. Слой выше — по номеру слоя `TLayer`
+ * (`data-layer`) и тем же правилом, по которому `TDismissPlugin` считает
+ * нажатие в такой список нажатием внутри (`isAboveLayer`): панель, в которую
+ * можно нажать, не должна быть немой.
+ *
+ * **Что прячется** — соседи оставленных узлов и соседи их предков вплоть до
+ * `body`. Вверх, а не только дети `body`: `TFrame` телепортируют и глубже
+ * (`target`), и тогда соседи панели внутри своего контейнера — тоже фон.
+ *
+ * **Набор пересчитывается, а не снимается при открытии.** Скрытый `TFrame`
+ * лежит в `body` уже смонтированным, а номер слоя пишет только показ, и
+ * скрытие его не снимает: у скрытой панели номера нет или он остался от
+ * прошлого показа. Список Select, открытый из окна, получает номер выше уже
+ * при открытом окне. Поэтому, пока фон спрятан, `MutationObserver` на `body`
+ * следит за составом поддерева и за `data-layer`: панель и её слой читаются
+ * на каждом пересчёте заново, а в DOM пишется только разница.
+ *
+ * **Слоёв бывает несколько** — окно поверх окна прячет и нижнее вместе с
+ * фоном, — поэтому пометка у узла одна на всех, со счётчиком (`marks.ts`):
+ * закрытие одного окна не снимает пометок другого, в каком бы порядке их ни
+ * закрывали, а последнее снятие возвращает то `aria-hidden`, что было у узла
+ * до первой пометки. Свои пометки плагин снимает при закрытии, при
+ * размонтировании корня и в `destroy()`.
+ *
+ * Открытость плагин ведёт сам — по свойству владельца (`property`, по
+ * умолчанию `open`), как `TScrollLockPlugin`; вручную — `enabled` при
+ * `property: null`. Документ берётся у корня, а не из `globalThis`:
+ * компонент живёт и в `iframe`.
+ *
+ * Чего плагин не делает: `aria-modal` пишет в свой набор ядро окна — это
+ * значение, а не операция; исключений для живых областей нет — фон
+ * прячется целиком, как у нативного `<dialog>`.
+ */
+export declare class THideOutsidePlugin extends TBasePlugin<any, THideOutsidePluginEvents> {
+    /** Умолчания опций, объявленных пропами, — см. `TDismissPlugin.defaultValues`. */
+    static defaultValues: Required<Pick<IHideOutsidePluginOptions, 'enabled'>>;
+    private _open;
+    private _dismiss;
+    private _element;
+    private _enabled;
+    /** `body` под наблюдением; `null` — фон не спрятан. */
+    private _body;
+    private _observer;
+    /** Узлы, которые пометил этот плагин: снимает он ровно их. */
+    private readonly _hidden;
+    install(ctx: IPluginContext, options?: IHideOutsidePluginOptions): void;
+    /**
+     * Спрятан ли фон. Владелец взводит это открытием; своё значение плагин
+     * держит и без корня — фон спрячется, как только корень объявят.
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    destroy(): void;
+    /** Фон спрятан ровно тогда, когда владелец открыт и корень объявлен. */
+    private _sync;
+    /** Пересчитать, что спрятать, и записать в DOM только разницу. */
+    private readonly _refresh;
+    /** Фон панели: всё в `body`, кроме неё и слоёв выше неё. */
+    private _outside;
+}