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

package/dist/custom/tooltip/trigger/trigger.plugin.d.ts

@@ -0,0 +1,133 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TTooltipTriggerPluginEvents } from './types';
+/**
+ * TTooltipTriggerPlugin — когда подсказка показывается и когда прячется.
+ *
+ * Подсказку держат две причины: **курсор** — он на корне или на панели — и
+ * **фокус с клавиатуры** внутри корня. Показывается она, когда появилась
+ * первая, прячется, когда ушла последняя:
+ * - курсор (не касание) — показ через `openDelay`, уход — скрытие через
+ *   `closeDelay`. Панель под курсором подсказку держит (WCAG 1.4.13): за
+ *   задержку скрытия курсор пересекает зазор между триггером и панелью;
+ * - фокус с клавиатуры (`:focus-visible`) показывает сразу, уход фокуса из
+ *   корня прячет сразу. Фокус от нажатия мышью на кнопку подсказку не
+ *   показывает: её уже показало наведение, а нажатие закрыло. Текстовое
+ *   поле браузер считает видимым и после клика — в нём печатают, — и
+ *   подсказка поля показывается.
+ *
+ * **Уход курсора прячет, только если его приход засчитан**: причиной курсор
+ * становится на `pointerenter`, который услышал плагин. Подсказку, открытую
+ * разметкой или из кода, курсор не держит, и уход без прихода её не
+ * закрывает. Такой уход получает подсказка, открытая с первой отрисовки: до
+ * первого кадра её панель стоит там, где её поставила привязка по нулевому
+ * размеру, — поверх триггера, — а слушатели корня и панели встают с
+ * объявлением корня, в том же кадре, где привязка уводит панель на место.
+ * Наведение браузер пересчитывает и без движения мыши, по раскладке, и
+ * неподвижный курсор оказывается над панелью раньше, чем на ней встали
+ * слушатели, а её переезд на место — `pointerleave`. Без правила подсказка
+ * закрывалась через `closeDelay` сама, если курсор стоял там, где панель
+ * легла до своего места.
+ *
+ * **Нажатие** на корень и **Escape** закрывают подсказку и гасят обе причины
+ * вместе с отложенным показом: курсор так и остаётся на триггере, фокус — на
+ * нём же, и снова показать подсказку может только новый заход курсора или
+ * новый фокус.
+ *
+ * Escape слушается на документе в фазе перехвата и только пока подсказка
+ * открыта: её закрывают, не сдвигая ни курсор, ни фокус (WCAG 1.4.13), а
+ * фокус может быть где угодно. Клавиша гасится `preventDefault`, а не
+ * `stopPropagation`, — как у всего слоя оверлея: поповер под подсказкой
+ * видит, что Escape уже потрачен, и сам не закрывается.
+ *
+ * Слушатели — на корне, а не на элементе триггера: в корне лежит только
+ * триггер, и прямоугольник у них один. Так подсказка работает и у
+ * выключенной кнопки — у неё `pointer-events: none`, и курсор попадает в
+ * корень.
+ *
+ * Нажатие мимо закрывает `TDismissPlugin`, он же помечает панель и находит её
+ * (`findPanel()`): она телепортирована, и ссылки на неё у плагинов нет. Без
+ * него панель подсказку не держит.
+ *
+ * Открытость плагин ведёт по свойству владельца, а не по своим флагам:
+ * `open` пишут и разметка, и код через инстанс. Любое закрытие — снаружи, мимо,
+ * соседней подсказкой — сбрасывает причины и таймеры, а подсказку на экране
+ * видит документ (`document-state.ts`): одна открытая и окно без задержки.
+ */
+export declare class TTooltipTriggerPlugin extends TBasePlugin<any, TTooltipTriggerPluginEvents> {
+    private _owner;
+    private _dismiss;
+    /** Корень: наведение, фокус и нажатие слушаются на нём. */
+    private _root;
+    /** Документ корня: на нём Escape и общее состояние подсказок. */
+    private _doc;
+    /** Панель, найденная при открытии, — курсор на ней держит подсказку. */
+    private _panel;
+    /** Стоят ли слушатели открытой подсказки: Escape на документе, курсор на панели. */
+    private _active;
+    /** Причина «курсор»: он на корне или на панели. */
+    private _hovered;
+    /** Причина «фокус»: фокус с клавиатуры внутри корня. */
+    private _focused;
+    private _showTimer;
+    private _hideTimer;
+    /** Эта подсказка для документа: открылась соседка — закрыться. */
+    private readonly _entry;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    private _bindRoot;
+    private _unbindRoot;
+    private readonly _onOpenChange;
+    /**
+     * Подсказка открылась: слушать Escape и курсор на панели, закрыть соседку.
+     * Отложенный показ больше не нужен — открыли и без него.
+     */
+    private _activate;
+    /**
+     * Подсказка закрылась (или корень ушёл): причины и таймеры сбрасываются,
+     * слушатели открытой снимаются. Снова показать её может только новый заход
+     * курсора или новый фокус.
+     */
+    private _deactivate;
+    /**
+     * Курсор на корне или на панели. Касание не в счёт: наведения у пальца
+     * нет, а `pointerenter` перед нажатием показал бы подсказку на каждое
+     * касание.
+     */
+    private readonly _onEnter;
+    /**
+     * Курсор ушёл с корня или с панели: без фокуса — скрытие с задержкой. Уход
+     * без засчитанного прихода причины не снимает и ничего не прячет (см.
+     * шапку): отложенного показа у него тоже нет — его заводит только приход.
+     */
+    private readonly _onLeave;
+    /** Нажатие на корень закрывает — и тем, кто навёл, и тем, кто пришёл фокусом. */
+    private readonly _onPress;
+    /**
+     * Фокус с клавиатуры показывает сразу. `:focus-visible` — эвристика
+     * браузера: фокус от Tab её включает, от нажатия на кнопку — нет, у
+     * текстового поля — всегда: в нём печатают.
+     */
+    private readonly _onFocusIn;
+    /** Фокус ушёл из корня: причина снята, без курсора — скрыть сразу. */
+    private readonly _onFocusOut;
+    /**
+     * Escape у открытой подсказки, где бы ни был фокус. Потраченную кем-то
+     * клавишу не трогает; свою гасит `preventDefault` (см. шапку).
+     */
+    private readonly _onKeyDown;
+    /** Нажатие и Escape: подсказка закрыта, обе причины и отложенный показ погашены. */
+    private _cancel;
+    /**
+     * Показ после `openDelay`, а без задержки — если другая подсказка открыта
+     * или только что закрылась (`document-state.ts`). Задержка читается здесь:
+     * новое значение действует со следующего наведения.
+     */
+    private _scheduleShow;
+    /** Скрытие после `closeDelay` — только у открытой. */
+    private _scheduleHide;
+    private _show;
+    private _hide;
+    private _cancelShow;
+    private _cancelHide;
+}

package/dist/custom/tooltip/trigger/trigger.plugin.js

@@ -0,0 +1,271 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { TDismissPlugin } from "../../dismiss/dismiss.plugin.js";
+import { tooltipClosed, tooltipOpened, tooltipSkipsDelay } from "./document-state.js";
+//#region src/custom/tooltip/trigger/trigger.plugin.ts
+/**
+* TTooltipTriggerPlugin — когда подсказка показывается и когда прячется.
+*
+* Подсказку держат две причины: **курсор** — он на корне или на панели — и
+* **фокус с клавиатуры** внутри корня. Показывается она, когда появилась
+* первая, прячется, когда ушла последняя:
+* - курсор (не касание) — показ через `openDelay`, уход — скрытие через
+*   `closeDelay`. Панель под курсором подсказку держит (WCAG 1.4.13): за
+*   задержку скрытия курсор пересекает зазор между триггером и панелью;
+* - фокус с клавиатуры (`:focus-visible`) показывает сразу, уход фокуса из
+*   корня прячет сразу. Фокус от нажатия мышью на кнопку подсказку не
+*   показывает: её уже показало наведение, а нажатие закрыло. Текстовое
+*   поле браузер считает видимым и после клика — в нём печатают, — и
+*   подсказка поля показывается.
+*
+* **Уход курсора прячет, только если его приход засчитан**: причиной курсор
+* становится на `pointerenter`, который услышал плагин. Подсказку, открытую
+* разметкой или из кода, курсор не держит, и уход без прихода её не
+* закрывает. Такой уход получает подсказка, открытая с первой отрисовки: до
+* первого кадра её панель стоит там, где её поставила привязка по нулевому
+* размеру, — поверх триггера, — а слушатели корня и панели встают с
+* объявлением корня, в том же кадре, где привязка уводит панель на место.
+* Наведение браузер пересчитывает и без движения мыши, по раскладке, и
+* неподвижный курсор оказывается над панелью раньше, чем на ней встали
+* слушатели, а её переезд на место — `pointerleave`. Без правила подсказка
+* закрывалась через `closeDelay` сама, если курсор стоял там, где панель
+* легла до своего места.
+*
+* **Нажатие** на корень и **Escape** закрывают подсказку и гасят обе причины
+* вместе с отложенным показом: курсор так и остаётся на триггере, фокус — на
+* нём же, и снова показать подсказку может только новый заход курсора или
+* новый фокус.
+*
+* Escape слушается на документе в фазе перехвата и только пока подсказка
+* открыта: её закрывают, не сдвигая ни курсор, ни фокус (WCAG 1.4.13), а
+* фокус может быть где угодно. Клавиша гасится `preventDefault`, а не
+* `stopPropagation`, — как у всего слоя оверлея: поповер под подсказкой
+* видит, что Escape уже потрачен, и сам не закрывается.
+*
+* Слушатели — на корне, а не на элементе триггера: в корне лежит только
+* триггер, и прямоугольник у них один. Так подсказка работает и у
+* выключенной кнопки — у неё `pointer-events: none`, и курсор попадает в
+* корень.
+*
+* Нажатие мимо закрывает `TDismissPlugin`, он же помечает панель и находит её
+* (`findPanel()`): она телепортирована, и ссылки на неё у плагинов нет. Без
+* него панель подсказку не держит.
+*
+* Открытость плагин ведёт по свойству владельца, а не по своим флагам:
+* `open` пишут и разметка, и код через инстанс. Любое закрытие — снаружи, мимо,
+* соседней подсказкой — сбрасывает причины и таймеры, а подсказку на экране
+* видит документ (`document-state.ts`): одна открытая и окно без задержки.
+*/
+var TTooltipTriggerPlugin = class extends TBasePlugin {
+	_owner = null;
+	_dismiss = null;
+	/** Корень: наведение, фокус и нажатие слушаются на нём. */
+	_root = null;
+	/** Документ корня: на нём Escape и общее состояние подсказок. */
+	_doc = null;
+	/** Панель, найденная при открытии, — курсор на ней держит подсказку. */
+	_panel = null;
+	/** Стоят ли слушатели открытой подсказки: Escape на документе, курсор на панели. */
+	_active = false;
+	/** Причина «курсор»: он на корне или на панели. */
+	_hovered = false;
+	/** Причина «фокус»: фокус с клавиатуры внутри корня. */
+	_focused = false;
+	_showTimer = null;
+	_hideTimer = null;
+	/** Эта подсказка для документа: открылась соседка — закрыться. */
+	_entry = { close: () => this._hide() };
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance();
+		this._dismiss = ctx.get(TDismissPlugin) ?? null;
+		this._listenTo(this._owner?.events, "change:open", ({ newValue }) => this._onOpenChange(newValue));
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => this._bindRoot(element));
+		elementPlugin?.events.on("removed", () => this._unbindRoot());
+	}
+	destroy() {
+		this._unbindRoot();
+		this._owner = null;
+		this._dismiss = null;
+		super.destroy();
+	}
+	_bindRoot(element) {
+		this._unbindRoot();
+		const target = element;
+		target.addEventListener("pointerenter", this._onEnter);
+		target.addEventListener("pointerleave", this._onLeave);
+		target.addEventListener("pointerdown", this._onPress);
+		target.addEventListener("focusin", this._onFocusIn);
+		target.addEventListener("focusout", this._onFocusOut);
+		this._root = element;
+		this._doc = element.ownerDocument;
+		if (this._owner?.open) this._activate();
+	}
+	_unbindRoot() {
+		const root = this._root;
+		if (!root) return;
+		const target = root;
+		target.removeEventListener("pointerenter", this._onEnter);
+		target.removeEventListener("pointerleave", this._onLeave);
+		target.removeEventListener("pointerdown", this._onPress);
+		target.removeEventListener("focusin", this._onFocusIn);
+		target.removeEventListener("focusout", this._onFocusOut);
+		this._deactivate();
+		this._root = null;
+		this._doc = null;
+	}
+	_onOpenChange = (open) => {
+		if (open) this._activate();
+		else this._deactivate();
+	};
+	/**
+	* Подсказка открылась: слушать Escape и курсор на панели, закрыть соседку.
+	* Отложенный показ больше не нужен — открыли и без него.
+	*/
+	_activate() {
+		this._cancelShow();
+		const doc = this._doc;
+		if (!doc || this._active) return;
+		this._active = true;
+		doc.addEventListener("keydown", this._onKeyDown, true);
+		const panel = this._dismiss?.findPanel() ?? null;
+		panel?.addEventListener("pointerenter", this._onEnter);
+		panel?.addEventListener("pointerleave", this._onLeave);
+		this._panel = panel;
+		tooltipOpened(doc, this._entry);
+	}
+	/**
+	* Подсказка закрылась (или корень ушёл): причины и таймеры сбрасываются,
+	* слушатели открытой снимаются. Снова показать её может только новый заход
+	* курсора или новый фокус.
+	*/
+	_deactivate() {
+		this._hovered = false;
+		this._focused = false;
+		this._cancelShow();
+		this._cancelHide();
+		if (!this._active) return;
+		this._active = false;
+		this._doc?.removeEventListener("keydown", this._onKeyDown, true);
+		this._panel?.removeEventListener("pointerenter", this._onEnter);
+		this._panel?.removeEventListener("pointerleave", this._onLeave);
+		this._panel = null;
+		if (this._doc) tooltipClosed(this._doc, this._entry);
+	}
+	/**
+	* Курсор на корне или на панели. Касание не в счёт: наведения у пальца
+	* нет, а `pointerenter` перед нажатием показал бы подсказку на каждое
+	* касание.
+	*/
+	_onEnter = (event) => {
+		if (event.pointerType === "touch") return;
+		this._hovered = true;
+		this._cancelHide();
+		if (!this._owner?.open) this._scheduleShow();
+	};
+	/**
+	* Курсор ушёл с корня или с панели: без фокуса — скрытие с задержкой. Уход
+	* без засчитанного прихода причины не снимает и ничего не прячет (см.
+	* шапку): отложенного показа у него тоже нет — его заводит только приход.
+	*/
+	_onLeave = (event) => {
+		if (event.pointerType === "touch" || !this._hovered) return;
+		this._hovered = false;
+		this._cancelShow();
+		if (!this._focused) this._scheduleHide();
+	};
+	/** Нажатие на корень закрывает — и тем, кто навёл, и тем, кто пришёл фокусом. */
+	_onPress = () => {
+		this._cancel();
+	};
+	/**
+	* Фокус с клавиатуры показывает сразу. `:focus-visible` — эвристика
+	* браузера: фокус от Tab её включает, от нажатия на кнопку — нет, у
+	* текстового поля — всегда: в нём печатают.
+	*/
+	_onFocusIn = (event) => {
+		const target = event.target;
+		if (!(target instanceof Element) || !target.matches(":focus-visible")) return;
+		this._focused = true;
+		this._cancelShow();
+		this._cancelHide();
+		this._show();
+	};
+	/** Фокус ушёл из корня: причина снята, без курсора — скрыть сразу. */
+	_onFocusOut = (event) => {
+		const next = event.relatedTarget;
+		if (next instanceof Node && this._root?.contains(next)) return;
+		this._focused = false;
+		if (this._hovered) return;
+		this._cancelHide();
+		this._hide();
+	};
+	/**
+	* Escape у открытой подсказки, где бы ни был фокус. Потраченную кем-то
+	* клавишу не трогает; свою гасит `preventDefault` (см. шапку).
+	*/
+	_onKeyDown = (event) => {
+		if (event.key !== "Escape" || event.defaultPrevented) return;
+		event.preventDefault();
+		this._cancel();
+	};
+	/** Нажатие и Escape: подсказка закрыта, обе причины и отложенный показ погашены. */
+	_cancel() {
+		this._hovered = false;
+		this._focused = false;
+		this._cancelShow();
+		this._cancelHide();
+		this._hide();
+	}
+	/**
+	* Показ после `openDelay`, а без задержки — если другая подсказка открыта
+	* или только что закрылась (`document-state.ts`). Задержка читается здесь:
+	* новое значение действует со следующего наведения.
+	*/
+	_scheduleShow() {
+		const owner = this._owner;
+		if (!owner || this._showTimer !== null) return;
+		const delay = this._doc && tooltipSkipsDelay(this._doc) ? 0 : owner.openDelay;
+		if (delay <= 0) {
+			this._show();
+			return;
+		}
+		this._showTimer = setTimeout(() => {
+			this._showTimer = null;
+			this._show();
+		}, delay);
+	}
+	/** Скрытие после `closeDelay` — только у открытой. */
+	_scheduleHide() {
+		const owner = this._owner;
+		if (!owner?.open || this._hideTimer !== null) return;
+		const delay = owner.closeDelay;
+		if (delay <= 0) {
+			this._hide();
+			return;
+		}
+		this._hideTimer = setTimeout(() => {
+			this._hideTimer = null;
+			this._hide();
+		}, delay);
+	}
+	_show() {
+		if (this._owner) this._owner.open = true;
+	}
+	_hide() {
+		if (this._owner) this._owner.open = false;
+	}
+	_cancelShow() {
+		if (this._showTimer === null) return;
+		clearTimeout(this._showTimer);
+		this._showTimer = null;
+	}
+	_cancelHide() {
+		if (this._hideTimer === null) return;
+		clearTimeout(this._hideTimer);
+		this._hideTimer = null;
+	}
+};
+//#endregion
+export { TTooltipTriggerPlugin };

package/dist/custom/tooltip/trigger/types.d.ts

@@ -0,0 +1,20 @@
+import type { TPluginEvents } from '../../../base';
+export type TTooltipTriggerPluginEvents = TPluginEvents;
+/**
+ * Подсказка глазами документа (`document-state.ts`): открытую документ умеет
+ * только закрыть — когда открывается другая.
+ */
+export interface ITooltipEntry {
+    /** Закрыть подсказку: у неё открылась соседка. */
+    close(): void;
+}
+/** Что документ помнит о своих подсказках. */
+export type TTooltipDocumentState = {
+    /** Открытая подсказка; `null` — открытой нет. */
+    open: ITooltipEntry | null;
+    /**
+     * Таймер окна после закрытия, в которое следующая подсказка показывается
+     * без задержки; `null` — окно прошло.
+     */
+    warm: ReturnType<typeof setTimeout> | null;
+};

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

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './virtual.plugin';

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

@@ -0,0 +1,6 @@
+import type { TPluginEvents } from '../../base';
+/**
+ * Своих событий у плагина нет: что рисует список, сообщает коллекция —
+ * расширение `draw`. Плагин только отдаёт ему замер и элемент с фокусом.
+ */
+export type TVirtualPluginEvents = TPluginEvents;

package/dist/custom/virtual/virtual.plugin.d.ts

@@ -0,0 +1,126 @@
+import { TBasePlugin } from '../../base';
+import type { IPluginContext } from '../../base';
+import type { TVirtualPluginEvents } from './types';
+/**
+ * TVirtualPlugin — the collection's window in the document: it measures the
+ * visible band and the step of the items, and tracks the item with DOM focus.
+ *
+ * What to draw is decided by the collection's drawing (`draw`); the plugin
+ * gives it what only the live document knows: which part of the list is
+ * visible (`notifyViewport`) and which item holds focus (the `focus` pin). The
+ * `Virtual` wrapper puts the plugin into the collection's bundle when the
+ * collection picks up its window: by then the engine is bound to the bundles
+ * registry, and the plugin takes item nodes from the registry of nodes. While
+ * there is no window, the plugin listens to nothing.
+ *
+ * **What scrolls the window.** The parent of the drawn items if it scrolls
+ * itself (ListBox with `maxRows`, the list in the Select panel), otherwise the
+ * nearest ancestor that scrolls vertically, otherwise the page. There is no
+ * prop: a block of limited height and the page work without setup. The
+ * container is looked up again when the size of the list or the container
+ * changes — with it changes whether the container scrolls.
+ *
+ * **One measurement a frame**, on scrolling of the container and the page, on
+ * resizing of the list and the container, on a change of what the collection
+ * draws, and when the first drawn item enters the document while none was in
+ * it: the markup may draw the entries later than the window has them — the
+ * Select panel builds its options from data on its first opening, and `drawn`
+ * does not change then. The band is the intersection of the container's
+ * window with the browser's, from the top of the list. The top of the list is
+ * the top of a drawn item minus its place times the step: the list may have no
+ * markup of its own at all (the header and footer of ListBox, the table
+ * body), and the items stand from its top a step apart. The step is the
+ * smallest distance between the tops of neighboring drawn items: no item is
+ * shorter than the step, the theme holds its height. With one item drawn — the
+ * previous step, and on the first measurement its height; no items in the
+ * document — no measurement. No box at the drawn item (the list is hidden) —
+ * no measurement either: from zero boxes the top of the list would slide to
+ * the start, and while the list is hidden the window would follow it frame
+ * after frame; this way it stays where it stood.
+ *
+ * **A tall item.** Items in the window share one height: an item taller than
+ * the step shifts the fillers, and scrolling drifts. The plugin finds such an
+ * item while measuring and warns in the console — once per mount.
+ *
+ * **Focus.** The item DOM focus came into is pinned in the window: scrolling
+ * does not take it out of the document while focus is in it. Focus moved to a
+ * node outside the component — no pin.
+ */
+export declare class TVirtualPlugin extends TBasePlugin<any, TVirtualPluginEvents> {
+    private _root;
+    private _draw;
+    private _elements;
+    /** Родитель нарисованных элементов: за его размером плагин следит. */
+    private _list;
+    /** Контейнер прокрутки; `null` — прокручивает страница. */
+    private _container;
+    private _resize;
+    /** За чьим размером наблюдатель следит сейчас: список и контейнер. */
+    private _observed;
+    /**
+     * Размер сменился — контейнер искать заново при замере. Не в колбэке
+     * наблюдателя: новый узел под наблюдением дал бы в том же кадре ещё одно
+     * уведомление, и браузер сообщил бы о петле.
+     */
+    private _containerStale;
+    private _frame;
+    /** Stops waiting for the first drawn node (`_awaitDrawn`); `null` — not waiting. */
+    private _waiting;
+    private _listening;
+    /** Последний шаг элементов: пока замерить нечем, полосу меряют им. */
+    private _step;
+    /** О высоком элементе уже предупредили. */
+    private _warned;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    private _bind;
+    /** Слушать документ — пока у компонента есть корень и стоит окно. */
+    private readonly _sync;
+    private _start;
+    private _stop;
+    /**
+     * Узнать список по нарисованному элементу: за размером его родителя
+     * следить, а контейнер искать заново, если сменился родитель или просят.
+     */
+    private _watchList;
+    /** Сменить контейнер прокрутки: прокрутку и размер слушать у нового. */
+    private _watchContainer;
+    /**
+     * Следить за размером списка и контейнера — пока слушаем документ. Узел,
+     * за которым уже следят, повторно не ставится: наблюдатель сообщил бы его
+     * размер заново.
+     */
+    private _observe;
+    /** Размер списка или контейнера сменился — может смениться и сам контейнер. */
+    private readonly _onResize;
+    private readonly _onSchedule;
+    /** Проход — раз в кадр: подряд идущие поводы схлопываются в один замер. */
+    private _schedule;
+    private _cancel;
+    private _measure;
+    /**
+     * Wait for the first drawn item to enter the document — its bundle
+     * registered and its node bound, in either order
+     * (`TCollectionElements.waitFor`), — and measure a frame later. The markup
+     * may draw the window's entries later than the window has them: the panel of
+     * a Select builds its options from data on its first opening, and `drawn`
+     * does not change then. Without a node there is no list to watch the size
+     * of, and nothing would schedule the measurement.
+     */
+    private _awaitDrawn;
+    /** Первый нарисованный элемент, у которого есть узел в документе. */
+    private _firstDrawn;
+    /** Видимая полоса: окно контейнера в окне браузера, без контейнера — окно браузера. */
+    private _band;
+    /**
+     * Шаг элементов — наименьшее расстояние между верхами соседних
+     * нарисованных элементов. Нарисован один — шаг прежний, а без прежнего —
+     * его высота; элементов нет — ноль. Элемент выше шага — предупреждение.
+     */
+    private _measureStep;
+    /** Нарисованный элемент, в узле которого лежит узел. */
+    private _itemOf;
+    private readonly _onFocusIn;
+    /** Фокус ушёл на узел вне компонента — закрепления нет. Ушёл из окна браузера — осталось. */
+    private readonly _onFocusOut;
+}